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Preface 


Documents are visual channels for communicating information, and so 
their effectiveness depends not only on their content but also on their appear- 
ance. At the basic level the appearance refers to the legibility of the content, 
whereas at higher levels it involves highlighting the logical units within the 
content. Setting the appearance of a document is called formatting. TpX is a 
system for specifying the formats of documents. 

The TpX system offers a rich assortment of low-level features and a pow- 
erful mechanism for defining high-level features. The low-level features can 
be used to specify the sizes of pages, the shapes of paragraphs, the fonts for 
characters, and other characteristics of a similar nature. Such features are 
considered to be low-level constructs because they deal with physical compo- 
nents within a document. 

In contrast, high-level features relate to logical structures like chapters, 
sections, figures, and lists within a manuscript. With high-level features, 
the users need only identify the logical structures within the document; the 
features take it upon themselves to assign appearances to these entities. That 
is, high-level features encourage the users to concentrate on issues of content 
and organization, and shield the users from issues that deal with appearances. 

The creator of the system, Donald E. Knuth, has developed a compre- 
hensive manual for TEX, The TEgXbook. A popular enhancement of TeX with 
high-level features for writing has been provided by Leslie Lamport, and is 
described in LaTEX: A Document Preparation System. Two enhancements of 
TEX for drawing and for programming, respectively, have been introduced by 
the author in TEX and LaTeX: Drawing and Literate Programming. 

The objective of this book is to introduce the central features of TEX and 
the philosophy that drives it. With such a background, a user can enhance 
TEX to meet personal needs, and he or she can better understand existing 
enhancements and the way they can be adjusted. The book is made up of 
three major parts. It starts with simple topics and gradually moves into more 
complex issues. 

Chapters 2 through 10 introduce the major features that make a low-level 
formatting language out of TEX. Most of these features require very little 
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sophistication from their users, and they can be employed in a brute force 
approach. In essence, these features are similar to the commands offered by 
popular formatting systems that are employed by the general public. 

Chapters 11 through 16 exhibit a component of TEX that makes it a 
programming language for defining new commands and new environments. 
Understanding the early features in these chapters does not require a major 
effort, but only seasoned users may be able to fully use the capabilities of the 
later features. A background in programming can turn out to be an asset in 
dealing with these chapters. 

For a large extent, the appendixes offer a natural continuation to the 
material covered in Chaps. 2 through 10. They introduce additional low-level 
features of TEX as well as some high-level features. The low-level commands 
are more esoteric than those that have been encountered earlier, and normally 
they are not used extensively. The higher-level commands provide the means 
to build ordinary tables and mathematical tables. 

The first chapter looks at how TEX can be accessed, and it offers a prim- 
itive approach for working with TEX, with almost no investment in learning 
the system (and not much access to the system). Chapter 17 exhibits a small 
enhancement for TEX and the principal features of LaTpX. 

Finally, I would like to thank the manuscript editor Alice Manning for 
suggesting many valuable corrections. 


Eitan M. Gurari 


WRITING 
WITH TFX 


Chapter 1 


GETTING STARTED 


TEX is a computer-based system for preparing documents. The system con- 


sists of a language and a translator. The users of the system describe the 
way they want their documents to look, utilizing features that the language 
provides. The translator takes these descriptions and rearranges them into 
modes that computerized printing devices can understand. 

This chapter looks at the process of preparing documents with TpX. 
Subsequent chapters introduce the special features of TgX. The first section of 
this chapter is concerned with the preparation of inputs, and the second deals 
with the manner in which TEX operates. The concluding section is devoted 
to the production of documents from TẸX outputs. 


1.1 Source Documents | 


Producing a document with TEX is a three-step process that is summarized in 
Fig. 1.1. In the first step, the user prepares a file that describes the document. 
The description, called the TEX document or the source document, is made 
up of text and instructions on how to format the text. 


Example. A source document can have the following form. 


True! Although the baths are currently closed, they 
are expected to be as good as new once they reopen. 
If nothing else, I've at least learned one thing 
out of this. Peter isn't that bad after all! \bye 


1.2 Running TeX 


In the second step, the user introduces the source document to TX for trans- 
lation. TX, in return, generates a dvi file and a log file. In addition, it 
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dvi formatted 
documenti document 
source 
document 
log file 


Figure 1.1 Document preparation with TpX. 


displays selected parts of the log file on the terminal screen. 

The dvi (device-independent) file contains a specification of the document 
in a device-oriented language. The log file contains information regarding the 
translation process, including error and warning messages. 

The details of how TFX runs may differ from one installation to another. 
However, throughout this book we will assume a process like the one the 
author uses, to allow for a common ground of communication. 


The author is required to use names of the form ‘a.’ for files. To 
process a source document that resides in file ‘abc.nm’, the author 
issues the command ‘tex abc.nm’ (the extension ‘.nm’ is optional when 
nm=tex). TEX, in return, outputs a dvi file named ‘abc .dvi’ and a log 
file named ‘abc.1log’. 


The author types ‘control-c’ when he wants to stop TEX in the middle 
of a compilation. 


The manner in which the translator TEX is activated may differ from one 
installation to another. Moreover, the translator itself may differ from one 
installation to another. Yet, the language TEX is identical for all installations. 
Hence, files that are written in TEX can be transmitted from one installation 
to another without affecting their outcome. 


1.3 Formatted Documents 


In the third step, the user provides the dvi file to an output device that 
produces a hard or soft copy of the document, called the formatted document. 


The author uses the command ‘dvi2ps abc.dvi | lpr -P (device 
name)’ to submit a dvi file ‘abc.dvi’ to a printer for a hardcopy, and 
he issues the command 'xdvi abc.dvi’ to get a display on the screen. 


The device-oriented language used in the dvi files is a device-independent 
language. Hence, like source documents, the dvi files are portable. 


Note. A notation similar to the one used above for the command ‘dvi2ps 
abc.dvi | lpr -P (device name)' is employed throughout the book. The 
darker characters stand for verbatim strings of characters, whereas the lighter 
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characters that are delimited by angular brackets act as place holders for the 
strings that they describe. 


Exercises 


1.3.1 Prepare a file containing the following source document, run it on TEX, 
and print out the formatted document. 


\hsize=4in {\noindent\hfil\bf SCENE III} 


The Stockmanns’ ended up staying in their town, and Peter did 
as he promised. At first not too many town people believed 
it. Eventually, though, things went back to normal and the 
Stockmanns stereotype had been erased entirely$\ldots$ \bye 


1.3.2 Prepare a file containing the following source document, run it on TpX, 
and print out the formatted document. 


We do not have to care about spaces between words 
and where line breaks are inserted. However, we 
should remember to insert blank lines between paragraphs. 


The characters {\tt \char 35\ \char 94\ 

\char 36\ \char 95\ \char 37\ \char 123\ 

\char 38\ \char 125\ \char 92} and {\tt\char 126} 
are considered to be special. We are very likely 
to get into trouble if we use them improperly. 


On the other hand, the characters {\tt < >} are 
not special. For the time being, we can consider 
them as being strange but not harmful. \bye 


1.3.3 Prepare a file containing the following source document, run it on 
TEX, and print out the formatted document. In the source document, replace 
each occurrence of ‘...’ with any text you choose. However, do not use 
the characters ‘V, *C, ‘}’, * 7, 507, °°’, p, ‘&, 8", 92, 1, <, or ‘>’ within the 


replacements that you provide. 


\newcount\c 
\long\def\title#i{\advance \c by 1 \medskip 

\noindent {\bf \the\c. #1} \smallskip} 
\title{...} ... \title{...} ... \title{...} ... \bye 


1.3.4 The environment that TpX offers is too rich and too complex to be fully 
described in any single book. Yet, once one acquires a basic understanding of 
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TEX, one can learn a lot just by probing the system's possibilities in a trial- 
and-error mode of operation. Can you determine the meaning of the following 


features of TEX? 

a. The command ‘\jobname’. 

b. The character ‘%’. 

c. The commands ‘\%’, ‘\$’, ‘\&’, NP, and ‘\_’. 
d. The commands ‘\bf’ and ‘\it’. 

e. The command ‘\hfill’. 


TeX AS A 
FORMATTING 
LANGUAGE 


Chapter 2 


WRITING WITHOUT 
SPECIAL FEATURES 


Source documents are made up of plain text and commands. The purpose 
of this chapter is to learn how TẸX processes plain text. Understanding this 
process is important for two reasons. The first and obvious reason is that such 
an understanding serves as a guide for preparing ordinary text. The second 
and less obvious reason is that some of TgX's commands are context-sensitive. 
Hence, to understand these commands, one needs to understand the contexts 
that can influence them. 

The chapter consists of five sections. The first section states what the user 
should and should not write in a source document to avoid interfering with 
the default behavior of TEX, the second is concerned with the way TẸX inter- 
prets its input files, and the third describes how TEX generates the formatted 
documents. The fourth section shows how comments can be introduced into 
source documents, and the fifth discusses the effect of irregularities in source 
documents. 


2.1 Plain Text and Special Characters 


TEX is an intricate system, and it is quite easy to lose control of it by issuing 
a wrong command. When it gets loose, TEX can become very annoying. 
However, normally our source documents consist mainly of plain text, and 
then it does not take much to control TEX. In fact, when we do not care 
about special features, we just need to obey the following pair of rules. 


o Avoid Using TEX Special Characters. The characters ‘\’, ‘{’, "T, I$, ‘2’, 
P, 1677, ©, ©", and " are considered to be special. These characters are 
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reserved for TeX commands. They should be avoided as long as we do not 
understand their meaning and the way they should be used. 


o Insert the String \bye at the End of the Source Document. The string 
\bye is a command which tells TpX where a source document ends. 


The next two sections describe how TEX interprets and processes plain 
text. However, with our current knowledge of TgX, we can already deduce 
most of this information by ourselves via experimentation. 


Example of Source Text Corresponding Formatted Text 

We can already deduce most of We can already deduce most of 
this information by ourselves this information by ourselves via ex- 
via experimentation. \bye perimentation. 


The characters that have been chosen to be special are infrequently used 
in ordinary text. Later on we will see how their symbols can be introduced 
into formatted documents, and how they (and other characters) can change 
from being special to being nonspecial. 


Unusual Characters 


Some characters act in an unexpected manner. Specifically, a single hy- 


phen character, ‘-’, produces a normal hyphen symbol, a sequence ‘-~’ of two 
hyphen characters produces an endash symbol, ‘~’, and a sequence '---' of 
three hyphen characters produces an emdash symbol, ‘—’. Hyphens are used 


for hyphenating words, endashes are used for denoting ranges, and emdashes 
are used for separating phrases. 


Example of Source Text Corresponding Formatted Text 

The five-mile tour---a The five-mile tour—a most in- 
most interesting one---is teresting one—is offered every day 
offered every day 8--7 8-7 during June-August. 


during June--August. 


On the other hand, the character ‘>’ in the source document stands for 
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the symbol ‘;’ in the formatted document, the character ‘<’ stands for the 


symbol ‘į’, and the character ‘|’ stands for the symbol ‘—’. 


2.2 Paragraphs, Sentences, and 
Words 


Writing plain text is as easy as typing the characters that make the words, the 
words that make the sentences, and the sentences that make the paragraphs. 
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Yet, we should be aware of the way TEX determines these units in a source 
document, because it varies somewhat from the way we normally do it. 


o Paragraphs. TEX disregards the format of its input files and uses a blank 
line to mean end of paragraph. 


Two or more consecutive blank lines are considered to be equivalent to 
a single blank line, and a blank line is considered to be a line that may 
contain only space characters. 


o Words. The space characters within the paragraphs are treated as word 
separators. 


Two or more consecutive space characters are considered to be equivalent 
to a single space character. The end-of-line characters within the para- 
graphs are treated as space characters. 


On the other hand, TgX ignores leading space characters in the input 


lines. Hence, leading space characters cannot serve as word separators. 
This property does not make a difference to us here, but it can make a 
difference when more complex situations arise. 

o Sentences. Words in TgX that end with period, ‘.’, question mark, ‘?’, 
exclamation mark, ‘!’, and colon, ‘:’, are considered to be the words that 


terminate sentences in TEX. However, words in which the punctuation 
characters are preceded by uppercase letters are an exception to this rule. 


The first two rules state how TeX breaks input files into paragraphs, 
and paragraphs into words. The third describes how TX collects words into 
sentences. 


Example. 'The following source text contains two paragraphs, each 
consisting of two sentences. 


One, two. Three, 
four! 


Four, three? Two, one. 


The text consists of the following eight distinct words in TEX: ‘One,’, 
‘two.’, ‘Three,’, ‘four!’, ‘Four,’, ‘three?’, ‘Two,’, and ‘one.’. 


2.3 What Is Done with the Inputs 
TgX reads a given input file character by character in the usual order, that 
is, left to right within a line and top down among the lines. It pauses from 
reading whenever it holds more text than can be fitted in one page as well as 
when no more input is left (that is, when \bye is reached). 

During each pause, TEX decides how much of the text that it holds will 
be moved into the next page of the formatted document and how the page 
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will be typeset. In particular, it decides how paragraphs will be broken into 
lines and how much space will be provided between words, sentences, and 
paragraphs. 

When TpX breaks the paragraphs into lines, it tries to right-justify the 
lines at the right margin by adjusting the spaces between the words (within 
some given limits) and by hyphenating words. When it breaks paragraphs 
between pages, it tries to avoid placing a single line of a paragraph on one 
page and the rest of the lines on another page. 


Example of Source Text Corresponding Formatted Text 

In the input, the first In the input, the first paragraph 
paragraph has has irregular numbers of space char- 

irregular numbers of space acters between words. 

characters between words. The second paragraph consists 


of two sentences. The paragraph is 


preceded by two blank lines. 
The second paragraph 


consists of two sentences. 
The paragraph is 
preceded by two blank lines. 


Horizontal and Vertical Modes 


TeX is assumed to be in horizontal mode when it is working inside the 
paragraphs, and to be in vertical mode when it is working outside the para- 
graphs (that is, beyond the end of a paragraph or before the first paragraph). 
The motivation for these modes arises from the ideal world as viewed from 
the perspective of TEX. 

In such a world, the pages have infinite width, and as a result each para- 
graph consists of a single line. Therefore, each contribution to a paragraph 
results in a horizontal addition to a line in the page. On the other hand, each 
contribution outside the paragraphs results in a vertical addition of a line or 
a space to a page. 

When TFX prepares a real page for a formatted document, it does so 
in two stages. In the first stage, it collects the text for the real page, while 
arranging the text on a factitious page of infinite width. In the second stage, 
TpX shrinks the factitious page horizontally to the dimensions of the real page 
by breaking paragraphs into lines. 


2.4 Comments 


The percentage character, ‘%,’, is a special character that is set aside for mark- 
ing comments in the source documents, Whenever TEX encounters a percent- 


age character, it ignores the character itself and all the other characters that 
follow in the input line. 
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Example. The source text for Sec. 2.2 of this book has the following 
form. The comments, vay the source text, outline the logical parts 
of the section. 


4- - - INTRODUCTION 
Writing plain text is as easy as typing... 


%- - - PARAGRAPH SEPARATORS 
..blank line to mean end of paragraph. 


%- - - WORD SEPARATORS 
..The space characters... 


4- - - SENTENCE SEPARATORS 
";..Words...that end with period... 


Input lines that contain just comments are ignored (recall that leading 
space characters do not count). 


Example of Source Text Corresponding Formatted Text 
Tw%...blah blah blah Two words. 

4. ..blah blah blah 
o words. 


2.5 Debugging Corner 


When TgX translates a source document into a formatted document, it writes 
messages about the translation onto the screen and into a log file as it goes. 
When the translation goes smoothly, the messages are predominantly statis- 
tical ones. 


É 


Example. The following is the output that TẸX provided on a source 
document that resided in file ‘xx.tex’. 
This is TeX, C Version 3.0 (no format preloaded) 
(xx.tex [1] [2] 
Output written on xx.dvi (2 pages, 10052 bytes). 


Transcript written on xx. log. 


TEX wrote 'xx.tex' when it started reading the file, it wrote ‘[1]’ 
when it shipped the first page to the dvi document, and it wrote ‘[2]’ 
when it shipped the second page. 


When TEX encounters problems in the translation, it issues error and 
warning messages. The messages reflect how TpX interprets the cause of the 


problems. 
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Error Messages 


The following are some of the more common complaints that are due to 
user errors. Each of these messages starts with the exclamation mark, ‘!’. 


! I can’t find file... 

! Text line contains an invalid character. 
! Misplaced alignment tab character &. 

! Missing $ inserted. 


! Undefined control sequence. 


! Use of ... doesn't match its definition. 
! Paragraph ended before ... was complete. 
! Argument of ... has an extra]. 


The messages are in general self-explanatory (as the first three should be 
by now). When TpX detects an error, it lists the appropriate message, gives 
the location where the error has been detected, and prompts the user (with 
the character ‘?’) for directions. 


Example. The following is an error message issued by TEX. 


! Misplaced alignment tab character &. 
1.91ab£& 
cd 


xs 


The error has been detected in line 91 (‘1.91’) of the source document. 
The error has been detected after reading ‘a b &' from the input line, 
with ‘c d' still left to be read from the line. The message complains 
that the symbol ‘&’ does not belong to plain text. 


Recovery from Errors 


The user can type the character ‘?’ at the prompt to investigate his or 
her options. In such a case, TEX responds with information of the following 
form and waits for directions from the user. 


Type «return» to proceed, S to scroll future error messages, 
R to run without stopping, Q to run quietly, 

I to insert something, E to edit your file, 

1 or ... or 9 to ignore the next 1 to 9 tokens of input, 


H for help, X to quit. 
? 
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Warning Messages 


When TpX fails to break lines or pages nicely, it issues messages of the 
following form. The messages explain the nature of the problems. 


o Overfull \hbox...— Line extends into the right margin. 


At its default setting, TEX marks the line in the formatted document with 
a black bar (like this: B). The bars can be avoided by changing the default 
setting with the command ‘\overfullrule=0pt’. 


o Underfull \hbox...— Line with too little text. 
o Overfull Nvbox... — Page with too much text. 
o Underfull \vbox...— Page with too little text. 


TEX does not stop when it encounters these problems. It just issues 
warning messages. 


Example. The following is a warning for a line that extends from a 
paragraph into the right margin. 
Overfull \hbox (52.74817pt too wide) in paragraph at 
lines 381--381 
(]\tentt Written material is easier to approach 


when formatted in attractive | 


The message indicates where the paragraph appears in the source doc- 
ument (lines 381-381), it states the extent to which the line extends 
into the margin (52.74817 points — 0.73 inch), and it shows the content 
of the line. 


We can ask TpX to refrain from producing the above warning messages by 
inserting the commands ‘\hfuzz=99in’, ‘\hbadness=10000’, ‘\vfuzz=99in’, 
and ‘\vbadness=10000’, respectively. 


Exercises 


2.1.1 Write a source document for the following formatted document. 


2.2.1 Write a source document for the following formatted document. (Your 
formatted document may differ from the one provided here, with respect to 
where the line breaks appear within the paragraphs.) 


A HAPPY TREE! 


One day there was a girl who planted a tree. She couldn't wait 
until it would grow. Every day she would check to see if it had grown. 
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One night when she was asleep the tree grew. When she woke up 
and saw her tree had grown, she danced around it. It had grown three 
inches. She was very happy. She hugged it. 


When she hugged it, it grew three more inches. She was very, very 
happy. 
2.3.1 Insert the command ‘\hsize=6in’ before the source text that you pre- 


pared for Exercise 2.2.1, and observe the outcome. Repeat the process for 
‘\hsize=3in’ and ‘\hsize=1.5in’. 
2.4.1 Insert the comment character ‘%,’ at the end of each line in the source 


file that you prepared for Exercise 2.2.1. How does this change affect the 
outcome? 


2.5.1 Prepare a source document that causes TEX to complain about ‘Over- 
full \hbox...’. 


2.5.2 Execute TeX on each of the following source documents. 


a. 'a^b \bye’ d. ‘afb \bye’ g. ‘\ab \bye’ 
b. 'a b \bye’ e. 'ajb \bye’ h. ‘ahb \bye’ 
c. ‘a$b \bye’ i f. ‘at#b \bye’ 


Chapter 3 
BASIC UNITS 


The basic units of languages are called tokens. In the case of TEX, the tokens 
are classified either as characters or as control sequences. In the previous 
chapter we got some insight into the role characters play in TgX, mainly that 
of data elements. In this chapter we initiate the study of control sequences. 

The chapter consists of three sections. The first section considers syn- 
tactical aspects of control sequences, and the second introduces a few control 
sequences that are commands of TEX. The third section looks at how tokens 
are scanned. i 


3.1 Control Sequences 


Control sequences are names given to commands, variables, and other en- 
tities of TEX. A source document consists entirely of control sequences and 
characters. The two kinds of tokens are distinguished in the following manner. 


so Control Sequences. A control sequence is a sequence of characters that^ 
* starts with an escape character. 
If the character following the escape character is not a letter, then the se- 
quence consists of just the escape character and the character that follows 
it. In such a case, the control sequence is also said to be a control symbol. 


If the character following the escape character is a letter, then the control 
sequence consists of the escape character and all the letters that follow it. 
In such a case, the control sequence is also said to be a control word. 


The backslash, ‘\’, is the character that TEX designates as an escape char- 
acter, and the characters in the English alphabet are the ones that TEX 
designates as letters. 


15 


16 BASIC UNITS 


o Characters. A character is considered to be a token if it does not appear 
within a control sequence. 


There can be relatively few tokens that do not contain letters, because 
each such token is made up of just one character (possibly preceded by an 
escape character), and the number of characters is small. 


Notation. In what follows, we will use the symbol ‘,,’ to denote a space 
character that we want to highlight. 


Example. The source text ‘ab \\\756\5\*\aaa3’ consists of the fol- 
lowing tokens: ‘a’, ‘b’, ‘4’, ‘\\’, ‘\u’, ‘7’, 65’, £6’, ‘\8’, IND, ‘\aaa’, 
and ‘3’. These tokens contain the following control sequences: ‘\\’, 
Nus *N5!, NS and 'Naaa'. 

Some control sequences are primitive features predefined in TEX from 
scratch. Some are nonprimitive features predefined in TEX (directly or indi- 
rectly) in terms of the primitive features. All other control sequences must be 
defined by the users. 

TEX provides about 300 primitive control sequences and about 600 non- 
primitive control sequences. Such versatility of features hands the users a 
powerful tool for fine tuning the formatted documents, at the cost of an in- 
creased investment of time and effort to learn and manage the system. 


3.2 A Few TẸX Commands 


We have already encountered the control word \bye, which TgX expects at 
the end of an input file, the control word \overfullrule, which TgX provides 
for adjusting the black bars that mark overfilled lines, and the control words 
\hfuzz, \hbadness, \vfuzz, and \vbadness, which control the warning mes- 
sages. The following list introduces a few more TEX control sequences. 


o \par. This control sequence marks the end of a paragraph; it has the same 


effect as a blank line. 


Example of Source Text Corresponding Formatted Text 
ab \par c d ab ^ E 
cd E i 


As is the case with blank lines, two or more consecutive \par commands 
are the same as a single \par. 

o \leavevmode. If it does not appear within a paragraph, the control se- 
quence starts a new paragraph without contributing any text. It is ignored 
if it appears within a paragraph. 

Example of Source Text Corresponding Formatted Text 


a \leavevmode b \par ab 
\leavevmode \par 
c c 
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ʻo \noindent. This command:has the same effect as \leavevmode, except 
that it removes the indentations at the start of the paragraphs. 


Example of Source Text Corresponding Formatted Text 
My fortune was to be a My fortune was to be a singer. 
singer. I take gymnastics. I take gymnastics. 


I'm on the team at gymnas- 
\leavevmode I’m on the team tics. 
at \noindent gymnastics. I love gymnastics. I love singing. 


\noindent I love 
gymnastics. I love singing. 


o \jobname. This control sequence provides the name, without the exten- 


sion, of the file that contains the source document. 
pal Eel ae led att hela rated ha ae 


Example of Source Text Corresponding Formatted Text 
If the input file has the . If the input file has the name 
name xx.nm, then we xx.nm, then we get xx. 


get \jobname. 


o Ny. This control symbol inserts a significant space character, not just a 
word separator. 


Example of Source Text . Corresponding Formatted Text 
AN single\ NV \ \ word. A single word. 

Two words. 
Two words. 


o \relax. This control sequence is a null command. It asks for no action. 


Example of Source Text Corresponding Formatted Text 


---, ~\relax-\relax-. DS aie 

The control words \par, \leavevmode, and \noindent are examples of 
context-sensitive commands. 

Specifically, in horizontal mode (that is, within a paragraph), the com- 
mand \par forces a transition to vertical mode. On the other hand, in vertical 
mode (that is, between the paragraphs), the command takes no action. 

The commands \leavevmode and \noindent work in an opposite man- 
ner. In horizontal mode, these commands take no action. On the other hand, 
in vertical mode, they force a transition to horizontal mode. 


3.3 The Scanning Process 


TEX reads its inputs character by character. As it reads the characters, it 
assembles them into tokens. Whenever it finds a token, it pauses. During 
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each pause, TEX processes the token in hand according to the meaning that 
the token carries. (Of course, TeX also pauses from reading whenever it holds 
more text than can be fitted into one page and when no more input is left. 
During each of these pauses, TEX decides how much of the text will be moved 
to the next page and how to format the page.) 

TEX ignores the space characters and line ends that succeed the control 
words in the input lines. 


Example of Source Text Corresponding Formatted Text 


a\relax abc 
b\relax c 


Exercises 


A. 3.2.1 Write a source document for the following formatted document, with- 
e. g 
out inserting blank lines in the source document. 


ON BROADWAY 
Cats 
Fiddler on the Roof 
Les Miserables 


OFF BROADWAY - 
And the World Goes ’Round 


Perfect Crime 


nf adgs- 3.2.2 Write a source document for the formatted document ‘12 3 4 5. 


Chapter 4 


FONTS 


Formatted documents can use different symbols. The symbols can look like 
the ones in this sentence, in the title of this chapter, or in the title of the 
following section. Similarly, the symbols can make an English alphabet, a 
Greek alphabet, or an alphabet for music notes. And so forth. 

TEX does not impose any constraint on the kind or number of symbols 
that it can process in general, but it sets a limit on the number of symbols 
that it can process at any given time. It deals with the different symbols by 
assuming that they are arranged into fonts and families of fonts. 


Normally, a font is considered to be a set of related symbols that have 
similar style and size. A family of fonts is assumed to be a set of fonts that 


differ only in the size of their symbols. 

"There are three sections to this chapter. The first section looks at fonts 
that are available to TEX, the second shows how new fonts can be added to 
TEX, and the third section ponders fonts more deeply. 


4.1 Readily Available Fonts 


Without any intervention from the users, TgX will monotonically use the same 
font throughout the formatted documents. To allow for changes in fonts, TEX 
offers five fonts and five corresponding commands to switch into these fonts. 


The commands are as follows: Xrm (roman), \bf (bold), \tt (typewriter), Nit 


italic), and \s1 (slanted). Initially, the roman font is the font that prevails. 


Example of Source Text Corresponding Formatted Text 


Roman \bf bold Mtt typewriter Roman bold typewriter italic 
Mt italic \sl slanted slanted roman. 
\rm roman. 
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Normally, we choose specific fonts for the shape and size of their symbols. 
The typewriter font is sometimes the font of choice just because it is a fixed- 
size font. That is, each of its characters has the same width, a property that 
is not shared by the other fonts. 

The typewriter font has one more property that it does not share with 
the other fonts. Namely, the characters ‘~’, ‘<’, ‘>’, and ‘|’, which have 
“strange” effects in the other fonts (see Sec. 2.1), produce “normal” effects in 
the typewriter font. 


Example of Source Text Corresponding Formatted Text 
\rm -, --, 7, €, >, |. 3m m h bs — 

a a e E i 
\tt 7,77, Ty Sy A |. 


4.2 Adding New Fonts 


The fonts that TEX offers do not belong to TEX. Instead, they are auxiliary 
tables of output symbols that are initially loaded into TgX. The control 


sequences Vrm, \bf, \tt, Nit, and \s1 are internal names that are assigned 
to these tables. 


Probing 


The tables also have external names that refer to the auxiliary files that 
hold these tables. We can find the external name of an active font with the 
command ‘\fontname\font’. 


Example of Source Text Corresponding Formatted Text 
\rm \fontname\font \par - emrl0 ime: ad ENTRA 
\bf \fontname\font \par cembx10 
\tt \fontname\font \par cmtt10 
\it \fontname\font \par cmtt10 
\s1 \fontname\font cmsl10 


In general, the computer systems in which TEX resides offer several files 
of fonts. 


Example. The system that the author uses offers hundreds of fonts. 
The following are the external names of a few of them: cmbx10, cmr5, 
cmri2, cmtt10, t-rom, and t-romsc. 

The fonts cmr5 and cmri2 are the only ones in this list that belong to 
the same family, called the computer modern roman font family. The 
font cmr5 contains symbols that are compatible with designs of size 5 
points, and the font cmr10 contains symbols that are compatible with 
designs of size 10 points. (Points are units of measure that typesetters 
use.) 
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New Styles 


We can add more fonts to those that are already loaded into TẸX. To 
load a font that has an external name (auziliary font name), we need to use 
a command of the following form. 


\font (internal font name)=(auziliary font name) 


The command loads the font into TgX and associates the internal name 
(internal font name) with the font. The internal name must be a control 


sequence, and it serves as a command for activating the font. 


Example. To load the font t-romsc under the internal name \rmsc, 
we just have to insert the command ‘\font\rmsc=t-romsc’. Then we 
can use the new font like any other TEX font. For instance, we can in- 
sert the source text ‘Roman Font, \rmsc Small Capital Roman \rm 
Font, and Mit Italic \rm Font’ to get the formatted text ‘Roman 
Font, SMALL CAPITAL ROMAN Font, and Italic Font’. 


The \font command loads fonts, but it does not activate fonts. The 
fonts are activated only by invocations of their internal names. 


Example of Source Text Corresponding Formatted Text 
\font\rmsc=t-romsc No change No change in font yet. ONLY NOW DO 
in font yet. \rmsc Only now WE HAVE A CHANGE. 


do we have a change. 


The \font command can also be used for changing the tables that are 
associated with existing internal font names. 


New Sizes 


Fonts of new sizes can be approached directly and indirectly. In the direct 
approach, one just needs to select the font with the right size from the desired 
family of fonts. 


Example of Source Text Corresponding Formatted Text 
\font\smallrm=cmr8 Old roman uses the font cmr10, new 
\font\rm=cmri2 Old roman roman uses the font cmr12, and 


uses the font \fontname\font, small roman uses the font cmr8. 
\rm new roman uses the 

font \fontname\font, 
\smallrm and small roman uses 

the font \fontname\font. 


In the indirect approach, the user needs to ask for a magnified version of 
a smaller font. This is done by referencing the external name of the smaller 
font together with the specification ‘scaled \magstep(magnification step)’, 
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Figure 4.1 Output table for \rm. 


for the desired magnification. The (magnification step) indicates the degree 
of the magnification, and it stands for an integer value between 0 and 5. 


Example of Source Text Corresponding Formatted Text 


\font\medbf=cmbx10 scaled Font cmbx10 at 12.0pt. 
\magstepi \medbf 
Font \fontname\font. 


Each degree of magnification increases the size of the symbols by a factor 
of 1.2. Hence, with degree of magnification i, the size of the symbols is 
increased by a factor of (1.2). For instance, a degree of magnification i = 2 
increases the size of the symbols by a factor of (1.2)? — 1.44. 


4.3 Greater Access to Symbols 


For each font we have a table that consists of 256 symbols, called the output 
table of the font. Figure 4.1 shows the first 128 symbols in the table that 
this book uses for the roman font, and Fig. 4.2 shows the first 128 symbols in 
the table of the typewriter font. The first 128 symbols in the tables are the 
"important" symbols of the tables, and in what follows we will assume that 
each table consists of just 128 symbols. 
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Figure 4.2 Output table for \tt. 


At each instant, only one output table is active. Initially, the output 


table of \rm is the one that is active. Thereafter, such a role can be assigned 
to other output tables through calls to their corresponding commands. 

In general, we do not have to bother with these tables. For example, 
when we want the symbol ‘a’ from the table of \tt, we just have to switch 
io the typewriter font and type the character 'a'. Similarly, when we want 
the character ‘@’ from the table of Xrm, all we need to do is to switch to the 
roman font and type the character ‘Q’. 


Indirect Access 


However, some symbols cannot be directly retrieved from the output ta- 
bles. Hence, TEX also offers the command ‘\char(character code)’ for access- 
ing symbols in output tables. The command produces the symbol at location 
(character code) in the active table, where the entries are counted rowwise. 


Example of Source Text Corresponding Formatted Text 


\rm \char 3 \char 11 \char 123 Aff-at{ 
\tt \char 3 \char 11 \char 123 


The commands ‘\char(character code)’ absorb the space characters that 
succeed the commands in the input lines. 
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Example of Source Text 


\char 38, \char 37 , and 
\char 35\ are special 
characters, but \char 64\ 


FONTS 


Corresponding Formatted Text 


&, %, and # are special characters, 
but @ is not. Typing = is as good 
as typing =. 


is not. Typing \char 61 \ 
is as good as typing =. 

The integer values (character code) in the \char commands are called 
character codes, because they are considered to be encodings for the characters 
of TgX. For instance, 64 is the character code of ‘@’, and 61 is the character 
code of ‘=’. 


Exercises 


4.1.1 For each of the following cases, write a source text that produces the 
formatted text. 


A large salad of fonts. c. Nation's Temperatures 
A 76 San Diego, California 
Adams, John 67 Denver, Colorado 


Adams, John Quincy 
Arthur, Chester Alan 
B 

Buchanan, James 


4.2.1 Write a source document for the following formatted document. (The 
title should use a magnified version of your italic font.) 


The Chocolate Hershey Kiss 


Once there was a chocolate Hershey Kiss. The Hershey Kiss was 
a girl. 


4.3.1 For each of the following cases, write a source text that produces the 
formatted text. 

a. 696 from $125 b. UPS AND DOWNS 
f Stars 

t Dreams 


+ Disappointments 


Chapter 5 


SPACES AND 
BREAKPOINTS 


The features that have been considered so far provide the users with extensive 
control over the printed symbols. But they offer very limited control over 
spaces, line breaks, and page breaks. The latter type of control allows us, 
for instance, to produce pages like this one—that is, to start chapters on new 
pages with spaces of desirable magnitude around the titles. 

The first section of this chapter looks at units of length that TEX recog- 
nizes. The second shows how a user can produce spaces of desired dimensions 
within paragraphs. The third section introduces commands for justifying text 
within lines, and the fourth considers vertical spaces between paragraphs. 
The fifth and sixth sections, which are the last for this chapter, deal with line 
breaks and page breaks. 


5.1 Units of Length 


Symbols have their sizes, lines have their dimensions, spaces between lines 
have their magnitudes, pages have their heights and widths, and so forth. 
These dimensions are predetermined by TFX, but they can be changed by the 
users. The following are some of the unit systems that TEX recognizes. 

in — Inches. 

mm — Millimeters (1in-25.4mm). 

pt — Points, a unit system that is used by typesetters (1in-72. 27pt). 


em — A unit system that depends on the font in use. In many fonts, 
1em is approximately the width of the symbol ‘M’. 
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ex — A unit system that depends on the font in use. In many fonts, 
iex is approximately the height of the symbol ‘x’. 


There are a few points that we should keep in mind with regard to di- 
mensions. 


o Dimensions are specified by decimal values, and they must mention the 
unit system in use (for instance, 3.2in, -75.98pt, 2em). 
o Dimensions that are specified by constants absorb the space characters 


that succeed them. 


o Sometimes commands that specify dimensions cause problems when they 
precede the word ‘plus’ or ‘minus’. In such cases, the word can be hidden 
from the commands by inserting the control sequence \relax between the 
words and the commands. 


5.2 Spaces within Lines << 
Spaces within lines of text are called horizontal spaces. They can be intro- 
duced with commands of the following form. - 
\hskip(dimension) . 
The commands produce horizontal spaces of size (dimension). 
Example of Source Text Corresponding Formatted Text 


x\hskip 0.25in x \par x x 
x\hskip 0.5in x \par x x 
x\hskip 1in x x B 


When TEX typesets text, it does so in the natural way. That is, it adds 
the insertions left to right along the lines. The command \hskip asks it to 
skip the specified distance along this path. The distance does not need to be 
positive. 


Example of Source Text Corresponding Formatted Text 
\tt Crossed\hskip -3.5em Crossed word. 
2zzzzz- word. 


The \hskip command is ignored in vertical mode. 


5.3 Text Justified within Lines 


When TFX breaks paragraphs into lines, it justifies each line at the left margin, 
and it tries to justify it at the right margin also. To this end, TEX stretches 
and shrinks the spaces between the words and the sentences. In addition, 
it issues ‘Underfull \hbox...’ warning messages to identify those lines in 
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which spaces are overstretched, and ‘Overfull \hbox...’ warning messages 
to identify those lines that have insufficient shrinking space. 

TEX offers two commands, named \hfil and \hfill, for letting the users 
control the distribution of extra spaces within the lines. Such a control gives 
the users the means to ask for different justifications for text. For instance, the 
users can ask for lines with centered text, as is the case for the page number 
at the foot of the first page of this chapter. Similarly, they can ask for lines 
with text flushed toward opposite margins, as is the case in the headline of 
this page. And so forth. 


Claiming Extra Spaces 


TEX inserts an implicit \nfil command at the end of each paragraph. 
After breaking a paragraph into lines, it typesets each line on a separate basis. 
It typesets lines that do not contain the commands \hfil and \hfill in the 
normal manner. On the other hand, in lines that contain such commands, 
TEX distributes the extra spaces among the commands. For the latter lines, 
TEX does not issue ‘Underfull \hbox...’ warning messages. 

In a line that contains only commands of the form \hfil, TpX distributes 
the extra spaces evenly among these commands. 


Example of Source Text Corresponding Formatted Text 
x x\par xx 

x\hfil x\par x x 
x\hfil\hfil x x x 


The implicit inclusion of the command \hfil at the end of the paragraphs 
is needed because when a paragraph is broken into lines, it normally is left 
with extra space in its closing line. Without the implicit command, the extra 
space would be distributed along the closing line instead of appearing just at 
the end. 


Example of Source Text Corresponding Formatted Text 
The end of the paragraph The end of the paragraph con- 
contains an implicit\hfil. tains an implicit 


In the default form, the leading line of each paragraph is indented. These 
indentations should be taken into account when the commands \hfil and 
\hfill are used within these lines. 


Example of Source Text Corresponding Formatted Text 
\noindent Left.\par Left. 

Almost left.\par Almost left. 
\noindent\hfil Centered.\par Centered. 


\leavevmode\hfil Not Centered. Not Centered. 
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In vertical mode, the commands \hfil and \hfill start new paragraphs 
before claiming their share of.the extra spaces. The paragraphs start with 
indentations. 


Example of Source Text Corresponding Formatted Text 
\noindent \hfil x \par x 
\leavevmode \hfil x \par x 

\hfil x x 


Priority of Commands 


The \hfill commands act like the \hfil commands, but they are more 
dominant. That is, in a line that contains the command \hfill, the extra 
spaces are distributed evenly among the \hfill commands. Moreover, in 
such a line, the \hfil commands are ignored. 


Example of Source Text Corresponding Formatted Text 
a\hfill b\hfil c a be 


The command \hfil cannot flush text rightward in the closing lines 
of the paragraphs, because the implicit \nfil commands at the end of the 
paragraphs claim their share of the extra spaces. For such cases, the command 
\hfill comes handy. 


Example of Source Text Corresponding Formatted Text 

A paragraph with the A paragraph with the last word 
last word flushed flushed rightward. 
\hfill rightward. Left center right. 


\noindent Left \hfill 
center \hfill right. 


5.4 Vertical Spaces and Vertical 
Justification 


Vertical spaces, that is spaces that appear between paragraphs, are quite often 
inserted around titles, at the end of chapters, and at locations where pictures 
need to be pasted. The vertical spaces are produced in a manner similar to 
the way the horizontal spaces are created. 


Vertical Skips 


The command ‘\vskip(dimension)’ is offered for skipping a vertical dis- 
tance of size (dimension). When the command appears within a paragraph, 
it terminates the paragraph before inserting the space. 
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Example of Source Text , Corresponding Formatted Text 
XXXXXXX XXXXXXX 

\vskip 0.18in XXXXXXX 

xxxxxxx\vskip 0.18in XXXXXXX 

XXXXXXX 


To encourage uniformity in the distribution of vertical spaces throughout 
the formatted text, TeX provides the commands \smallskip, \medskip, and 
\bigskip. The commands are variants of \vskip which insert vertical spaces 
of small, medium, and big sizes, respectively. 


Example of Source Text ; Corresponding Formatted Text 


Medium vertical space. ' Medium vertical space. 
\medskip Big vertical space. 


\bigskip The end. Big vertical space. 


The end. 
Vertical Fillers 


Extra vertical spaces may occur between paragraphs when pages with 
too little text are encountered. The users can control the distribution of the 
extra spaces with the commands \vfil and \vfill. 


Example of Source Text i Corresponding Formatted Text 
Top of page. \vfill ^ Top of page. 

Middle of page. Nvfill . 

Bottom of page. Middle of page. 


Bottom of page. 


TeX introduces the command \vfill when it encounters the command 
\bye at the end of a document. The other pages do not get implicit commands 
of this kind. 

The commands \vfil and \vfill work in a manner similar to \hfil 
and \hfill, respectively. They look at pages within documents in a manner 
similar to the way the previously discussed commands look at lines within 
paragraphs. 


5.5 Forced Line and Page Breaks 


TpX takes it upon itself to determine where line and page breaks should 
appear. It determines these locations based on aesthetic criteria. It provides 
superb results for uniform text, but it needs some help when special fragments 
of text are encountered. For instance, it cannot by itself determine the page 
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breaks that precede new chapters. Therefore, TẸX lets the users provide 
their input with respect to where line and page breaks should and should not 
appear. 

Breakpoints can be inserted with the \break command. Within para- 
graphs (that is, in horizontal mode), the command causes line breaks, whereas 
between paragraphs (that is, in vertical mode), the command generates page 
breaks. 


Example of Source Text Corresponding Formatted Text 
Text before the break. \break Text before the break. 
Text after the break. Text after the break. 


Normally, forced breakpoints cause overstretching of existing spaces (and 
warning messages). In such cases, the commands \hfil, \hfil1, \vfil, and 
\vfill can be used to claim the extra spaces. 


Example of Source Text Corresponding Formatted Text 

One two three. \break One two three. 
One \hfil two three. \break One two three. 
One two three. One two three. 


TEX removes the spaces that appear after breakpoints. That is, TEX 
removes the horizontal spaces from the start of a line, and the vertical spaces 
from the top of a page. However, spaces at the start of a paragraph stay 
intact, because they are not preceded by breakpoints. 


5.6 Prohibited Breakpoints 


A page break immediately after a section title might create quite an awkward 
situation. The same is true of a line break between a first name and middle 
initial. Such breakpoints can be prevented with \nobreak commands. These 
commands prevent line breaks if they are inserted in horizontal mode, and 
they prevent page breaks if they are inserted in vertical mode. 


Example of Source Text Corresponding Formatted Text 

No line break here. No line break here. No page 
\nobreak break here. 

No page break here. Other locations are fine. 


\par \nobreak 
Other locations are fine. 
The special character ‘~’ is a variant of the command \nobreak. Like the 
command \nobreak, the character ‘~’ prevents line breaks. But, in addition, 
the character ‘~’ also introduces a space character. 


Example of Source Text Corresponding Formatted Text 


Chapter^5, pages^6 and^7, Chapter 5, pages 6 and 7, Ms. Y, 
Ms.^Y, and so on. and so on. 
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Exercises 


5.1.1 TEX complains when it gets a source document of the form ‘x\hskip 
3in plus x equals 2x \bye’. Use the \relax command to fix the problem. 


5.2.1 Create the following symbols from the symbols that the typewriter font 
offers: 0, >, >, —. 

5.3.1 For each of the following cases, write a source text that produces the 
formatted text. 


a. PLAYOFFS 
Yesterday’s Game 
Albany 89, Witchia Falls 88 
(Albany leads series 3-2) 
Today’s Game 
Tacoma at St. Louis, 8:35p.m. 
Tomorrow’s Game 
Minneapolis at Denver, 9:05p.m. 


(if necessary) 


b. Sections in this chapter Pages 
Units of Length 25 
Spaces within Lines 26 
Text Justified within Lines 26 
Vertical Spaces and Vertical Justification 28 
Forced Line and Page Breaks 29 
Prohibited Breakpoints 30 

c. 123 Our Street 


Our Town, Our State 12345 
March 23, 1991 
Dear Friend, Just wanted to say hello, Love from us all. 


5.5.1 Produce the formatted text for the following source text, and determine 
the differences between the constructs ‘\break’, ‘\par\break’, ‘\hfil\break’, 
and ‘\vfil\break’. 


\noindent\hfil PART I 
I used to wear white, training, itching diapers, \break 


and now I put on colorful, stretchy, good-feeling 
pants. \par\break 
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à 


\noindent\hfil PART II 


I used to run like a tiger with diapers on and the 


rest naked, \hfil\break 
But now I walk like a giraffe with shoes, pants, 
and shirt on. \vfil\break 


\ Wfill \hfil THE END \bye 


Chapter 6 


LAYOUT OF PAGES 


J 


Each page of a formatted document consists of a body, a header, and a footer. 
Each body, in turn, consists of paragraphs, spacings, and other elements. TEX 
provides variables for controlling these entities, and it sets the variables to 
some default values. Yet it expects that the users will change the default 
values in order to customize the system to their personal needs. 

The purpose of this chapter is to introduce some of these variables and the 
manner in which they can be used. The chapter consists of seven sections. The 
first section gives an overview of the variables, the second looks at headers and 
footers, and the third considers the dimensions of pages. The fourth section 
is engaged with local adjustments to margins. The fifth section examines 
indentations at the start of the paragraphs, whereas the sixth is concerned 
with spacing of lines and paragraphs. The last section deals with the timing 
in which changes take effect. 


6.1 The Variables 


TEX has many variables that have a say on how text should be arranged 
within pages. Some of these variables can be used to achieve exotic results. 
However, our interest here is restricted to ordinary, down-to-earth features. 

Figure 6.1 lists the major variables that affect the layout of the pages. 
Each of the variables is a control sequence that holds some default value. 
Except for the variable \headline and the variable \footline, the value 
of each of the variables (variable) can be reset by à command of the form 
* (variable) -(dàimension)'. 
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p\hoffset 


\voffset \hsize 


\headline 
See 
SS 

\parindent  MENHENENEEEEEEEEIEEN 

. 

\leftski 


P 
arstin 


en rightskip 
—' \baselineskip 


bee ents a a a] 
\vsize| M 
L. \footline 


Figure 6.1 Page layout. 


6.2 Headers, Footers, and Page 


Numbers 


When TFX is about to ship out a page of formatted text, it attaches a header 
and a footer to the body. The header is a line of text that gets its content from 
the variable Nheadline, and the footer is a line of text that gets its content 
from the variable \footline. Initially, \neadline asks for blank headers and 
\footline asks for footers with the page numbers at their center. 

The users can change the default settings with commands of the form 
‘\headline={(token list)}’ and ‘\footline={(token list)}’, respectively. In 
the commands, (token list) stands for the values that should be stored in the 
variables \headline and \footline. 

The braces within the commands serve as delimiters for the values that 
the variables get. The values are fragments of text, and page numbers can be 
introduced into these fragments of text with the instruction ‘\the\pageno’. 


Example. The command ‘\headline={\hfil\rm \the\pageno}’ asks 
for headers which consist of page numbers that are justified rightward. 
The command ‘\footline={\hfil}’ asks for blank footers. The com- 
mand ‘\footline={}’ also asks for blank footers, but it implies ‘Un- 
derfull \hbox...’ warning messages for the footers. 


6.3 Widths and Heights 


Setting dimensions is a trivial task in TEX, and resetting them is as easy a task. 
The ability to set and reset dimensions is quite a useful option. It allows users 
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to reserve large empty areas for pencil writing during development stages. 
And it allows for experimentation during the stages in which the appearance 
is finalized. 

The dimensions of the bodies are determined by the variables \hsize 
and \vsize, and the offsets are determined by the variables \hoffset and 
\voffset. 


Example of Source Text Corresponding Formatted Text 
\hsize=1.1in A fragment of 

A fragment of text text that is type- 

that is typeset to set to a width of 

a width of 1.1 inches. 1.1 inches. 


The variables can be used to provide different dimensions to different 
pages. However, in general, the dimensions are fixed at the start of a doc- 
ument, and are never changed again in that document. Such an approach 
encourages uniformity throughout the document. 


6.4 Margins 


Insertions, like quotations within running text, quite often are highlighted 
by adjustments to their margins. The variables \leftskip and \rightskip 
regulate local adjustments to the left and right margins of the paragraphs, 
respectively. Initially, these variables are set to equal 0 points. 


Example of Source Text \rightskip=0em 


Some fairy tales start 


in the following manner. But they all end on a 


sweet note. 


\leftskip=4.1em ! 
ightskip-4.1 ; 

a TN Corresponding Formatted Text 
\noindent Once upon a Some fairy tales start in the fol- 
time there was a... lowing manner. 

Once upon a time 

there was a... 
\leftskip=0em But they all end on a sweet note. 


Positive values in the variables move the margins inward. The values 
assigned to the variables can also be negative in magnitude. In such a case, 
instead of getting margins that are moved inward, we get margins that are 
moved outward. 


36 LAYOUT OF PAGES 


Example of Source Text Corresponding Formatted Text 

This text is typeset This text is typeset along the 

along the global margins global margins of the “page.” 

of the ‘‘page.’? The right margin has been locally ad- 
justed 10 millimeters outward for this para- 

\rightskip=-10mm graph. 


The right margin has been 
locally adjusted 10 
millimeters outward for 
this paragraph. 


6.5 Indentations 


TEX typesets paragraphs with indentations in their leading lines, and it offers 
the variable \parindent for controlling the size of the indentations. The 
variable can hold a positive, zero, or negative value. Positive values give 
regular inward indentations. Zero values are equivalent to no indentations. 
Negative values provide for outward indentations. 


Example of Source Text an inward indentation of 


\parindent=-40pt tuenty pointa: 


\leftskip=40pt 


The first paragraph has a 


hanging indentation. The Corresponding Formatted Text 


indentation has a length The first paragraph has a hanging 
of forty points. indentation. The indenta- 
tion has a length of forty 
\parindent=19pt \leftskip=0pt points. 
The second paragraph has an in- 
The second paragraph has ward indentation of twenty points. 


The command \noindent can be used to prevent indentations in specific 
paragraphs (see Sec. 3.2). 


6.6 Vertical Spacings 


The previous chapter introduced the commands \vskip, \vfil, and \vfill 
for controlling vertical spaces between paragraphs on a case-by-case basis. 
However, in some situations we want to control vertical spaces on a more 
general basis. For instance, when we move to a new paragraph that uses 
a larger font size, we may want to increase the spacing between the lines. 
Similarly, when we switch to paragraphs with no indentation, we may want to 
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have more space between the paragraphs, to highlight the boundaries between 
the paragraphs. The variables \baselineskip and \parskip allow us exactly 
this kind of control. 

Specifically, the variable \baselineskip controls the vertical distances 
between the baselines of consecutive lines. On the other hand, \parskip sets 
extra vertical spaces between the paragraphs. 


Example of Source Text Corresponding Formatted Text 


\baselineskip=16pt The distance between the bases 
\parskip=10pt 

The distance between the 
bases of consecutive 
lines is 16 points. 


of consecutive lines is 16 points. 


Extra vertical space of 10 points 


is inserted between the paragraphs. 


Extra vertical space of 
10 points is inserted 
between the paragraphs. 


6.7 When Changes Take Effect 


The different variables that are shown in Fig. 6.1 can change their values 
anywhere in a document. For a given paragraph, the values that \parindent 
and \parskip hold at the start of the paragraph (that is, upon entering 
horizontal mode) are the ones that prevail. On the other hand, the values 
that \hsize, \leftskip, \rightskip, and \baselineskip hold at the end 
of the paragraph (that is, upon reentering vertical mode) are the ones that 
prevail. 


Example of Source Text Corresponding Formatted Text 


\parindent=0em \leftskip=2em This paragraph starts with an in- 
3 ' dentation of 0 em (= no indenta- 
This paragraph starts 
with an indentation of 
0 em (= no indentation). graph is moved 1 em inward. 
The left \parindent=1em 
\leftskip=1em 
\baselineskip=16pt 
margin of the paragraph is 
moved 1 em inward. 


tion). The left margin of the para- 


Exercises 


6.2.1 Set the footers to display the text ‘Page (page number)’ at the center 
in italic font. 
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6.4.1 Prepare a source text for the following formatted text. Obey the spec- 
ifications mentioned within the text. 


The page has width of 3.05 inches. No ad- 
justments have been made to the margins for this 
paragraph. 

The right margin of 
this paragraph is adjusted 
1.5 inches inward. 

The left margin of this para- 
graph is adjusted 1.1 inches in- 
ward. 


6.5.1 Give a source code that produces the formatted text below. 


4 FONTS 19 
4.1 Readily Available Fonts 19 / 4.2 Adding New 
Fonts 20 / 4.3 Greater Access to Symbols 22 / Ex- 
ercises 24 

5 SPACES AND BREAKPOINTS 25 
5.1 Units of Length 25 / 5.2 Spaces within Lines 26 / 
5.3 Text Justified within Lines 26 / 5.4 Vertical 
Spaces and Vertical Justification 28 / 5.5 Forced 
Line and Page Breaks 29 / 5.6 Prohibited Break- 
points 30 / Exercises 31 

6 LAYOUT OF PAGES 33 
6.1 The Variables 33 / 6.2 Headers, Footers, and 
Page Numbers 34 / 


6.5.2 A variable named \parfillskip determines the amount of space that 
should be introduced at the end of each paragraph. In its default setting 
the variable holds a value that produces the same effect as \hfil. Try other 
settings for the variable and observe the outcomes. 


Chapter 7 
GROUPS 


Generally speaking, a group is just a collection of entities that have something 
in common. When we talk about a group, we envision some imaginary sphere 
which encloses the entities, giving them, viewed externally, a unity and, viewed 
internally, a boundary. 

For us here, groups serve a similar purpose. The first section of this 
chapter introduces two grouping mechanisms of TEX, the second deals with 
local environments that groups enclose, and the third considers nested groups. 
The fourth section concludes the chapter with another look at the grouping 
mechanisms. . 


7.1 How They Are Defined 


Sequences of tokens can be made into groups by enclosing them between 
braces, ‘{’ and ‘}’, or between the control sequences \begingroup and \end- 
group. We refer to these groups as braced groups and blocked groups, respec- 
tively. The groups take the following forms. 


o Braced: 1...) 
o Blocked: \begingroup...\endgroup 


Braced Groups 


The grouping of tokens does not by itself affect the outcome. 


Example of Source Text Corresponding Formatted Text 
af{bc}d \par abcd 
abcd abcd 
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However, groups can cause side effects because they can change the way 
the input characters are interpreted. For instance, TEX ignores leading space 
characters in the input lines, space characters that succeed control words, and 
space characters that succeed other space characters. But groups can change 
the way TpX views such characters. 


Example of Source Text Corresponding Formatted Text 
a b \par ab 

a Q b \par a b 

a (1) b \par a b 

a {} {} b War a b 

a\relax b \par ab 

a{\relax} b \par ab 

a\relax{} b \par ab 

eames yee — ert 


Blocked Groups 


When we prepare a document, we work not only with the formatted text 
but also with the source text. Therefore, the clarity of source documents is 
an important issue for us. 

When we work with short groups, braces seem to be the better choice for 
defining the groups. This is so because braces are a compact notation. They 
do not divert too much attention from the tokens of the groups, but they are 
still noticeable. 

On the other hand, when we work with long groups, the control sequences 
seem to be the better choice for defining the groups. The reason for preferring 
them is that the control sequences attract the attention needed to highlight 
the boundaries of the groups. 


Example of Source Text Corresponding Formatted Text 
\begingroup abcdef 

abc 

def 
\endgroup 


A possible side effect of braced groups is additional spaces. On the other 
hand, using blocked groups can result in loss of spaces. This is the case because 
control words absorb the space characters that succeed them. Otherwise, 
blocked groups have side effects similar to those of braced groups. 


Example of Source Text Corresponding Formatted Text 
a b c \par abc 
a\begingroup b c \endgroup ab c — -— 


---- -Nbegingroup--- endgroup 
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7.2 What Are They Doing 


TEX provides an environment for writing. In addition, it also offers commands 
for modifying that environment. So far we have encountered only a few com- 
mands of this nature, namely, commands for changing fonts and commands 
for changing dimensions. Moreover, we saw that the changes that these com- 
mands produce prevail until they are canceled by the effect of consecutive 
applications of similar commands. 

The motivation for including the grouping mechanism within TẸX is to 
enable the definition of local environments, an option that results from the 
following property. 


The Property of Groups. Changes made within a group have effect 
only within the boundaries of the group. 


Groups and Fonts 


By delimiting the scope of commands, groups in effect define local en- 
vironments. When the text leaves a local environment, the conditions are 
restored to those that existed just before it entered the local environment. 


Example of Source Text Corresponding Formatted Text 
{\sl Emphasized} and | Emphasized and highlighted frag- 
{\bf highlighted} ments of text. 


fragments of text. 


Local environments allow for uniformity of conditions within their scopes, 
and they safeguard the surrounding environments from unwanted modifica- 
tions. 


Example of Source Text Corresponding Formatted Text. 

The source text The source text “one two... three” 

**Nrm one (Mt two...) ` is superior to “one two... three." 
three’? i 


is superior to 
‘‘\rm one Mit two... 
\rm three.?? 


Groups and Dimensions 


Groups have similar effects on changes that are made to dimensions as 
on those that are made to fonts. 
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Example of Source Text Corresponding Formatted Text 
I’m seven. My birthday is I’m seven. My birthday is July 5. 
July^5. I’ve made about I’ve made about 56 books. 
56 books. I love making books. I 
started making books in first 
\begingroup \rightskip=3em grade. 
I'm in second grade now. I ama 
I love making books. I twin. 


started making books in 
first grade. 


\endgroup I’m in second 
grade now. I am a twin. 


The variables that specify the layout of the pages are consulted only at 
certain scattered instants (see Sec. 6.7). For instance, \parindent is consulted 
for its value only when new paragraphs are being started, and \leftskip 
and \rightskip are consulted for their values only when the ends of the 
paragraphs are reached. Hence, special attention must be given to groups 
that enclose changes to such variables. 


Example of Source Text Corresponding Formatted Text 
\begingroup \leftskip=5em End of paragraph is reached af- 
End of paragraph is ter the end of the group. 
reached {\bf after) the End of paragraph is 
end of the group. reached before the end 
\endgroup of the group. 


\begingroup \leftskip=5em 
End of paragraph is 
reached {\bf before} the 
end of the group. 

\par\endgroup 


7.3 Groups within Groups 


Two or more groups can coexist together. But distinct groups must be either 
disjoint or totally nested one within the other. 


Example of Source Text Corresponding Formatted Text 
One, {\bf two, One, two, three, four, three, two, 
\begingroup \it three, one. 


{\tt four,} three, 
\endgroup two,} one. 
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Groups that are opened with left braces, ‘{’, must be closed with right 
braces, ‘}’, and groups that are opened with the control sequence Nbegingroup 
must be closed with Nendgroup. 


7.4 Some Differences 


Braces and the control sequences \begingroup and \endgroup have identical 
outcomes on the groups that they define. However, the braces and control 
sequences are not equivalent with respect to how they can be used. 


Braces without Groups 


Every pair of matching \begingroup and \endgroup defines a group. On 
the other hand, this is not the case for braces, because braces also serve as 
delimiters for parameters of commands. For instance, the braces serve as de- 
limiters in the commands ‘\headline={(token list)? and ‘\footline={(token 
list)Y' that we encountered in Sec. 6.2. Or, as another example, consider the 
command ‘\uppercase{(tezt)}’. The new command has one parameter, de- 
noted here by (tezt), that is delimited by braces. The command replaces each 
lowercase character in (tezt) with a corresponding uppercase character, if the 
character is a token. E 


Example of Source Text Corresponding Formatted Text 
Vuppercase(A \bf bc(1)] A BC(1) 


Only for Blocked Groups 


Some applications can employ blocked groups but not braced groups. 
These applications include the control sequences \begingroup and \end- 
group within parameters of commands without balancing the contro] se- 
quences within each parameter, an option that is not available through braces. 


Example of Source Text Corresponding Formatted Text 
Nuppercasefa ABcB 

\begingroup Mit b} 

c \endgroup B 


Only for Braced Groups 


In some cases, like *'$a^(n*1)$' (see Sec. 8.3) and ‘\hbox{a b cY (see 
Sec. 10.1), commands can be applied to groups. However, in such cases, the 
group must be braced. 
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Exercises 


7.2.1 Prepare a source text for the following formatted text. Do not use any 
control sequence more than once within the source text. In addition, follow 
the specifications that are mentioned within the formatted text. 


This paragraph has width of 3 inches. The 
paragraph employs the italic font. 

The current paragraph uses 
the boldface font. The left mar- 
gin is adjusted 0.7 inch inward. 

This paragraph has the same specifications as 
the first paragraph. 


7.3.1 TX allows users to insert the control sequence \aftergroup before 
tokens that are included within groups. Can you figure out the meaning of 
the control sequence? 


Example of Source Text Corresponding Formatted Text 
( ab \aftergroup cd }. abdc. XY Y X. Disjoint groups? 
( XY Naftergroup Mit YYY 


\aftergroup XY }. 
Disjoint groups? 
\begingroup \it Y {\bf Y 
\aftergroup\endgroup Y } 


Chapter 8 . 


MATHEMATICAL 
FORMULAS 


Mathematical notations are distinguished from regular text by the choice of 
fonts, by the frequency within which fonts are changed, by the spacing between 
the symbols, and by the vertical positioning of the symbols. TpX simplifies 
the writing of mathematical formulas by providing a math mode in which it 
takes the responsibility for formatting the formulas. 

This chapter consists of five sections. The first section shows how text is 
assigned the meaning of a formula, the second introduces control sequences 
for accessing mathematical symbols, and the third considers superscripts, sub- 
scripts, and fractions. The fourth and fifth sections look at how users can 
change the fonts and the spacings within the formulas. 


8.1 How They Are Defined 


For TEX, formulas are just fragments of text that are processed in math mode. 
Formulas that are embedded within regular lines of text are called inline 
formulas, and formulas that appear between regular lines of text are called 
displayed formulas. Within source documents, inline formulas are delimited 
by the character ‘$’ at their start and end points. 


Example of Source Text Corresponding Formatted Text 

The formula $atb=b+a$ The formula a+b = b+a is formatted 
is formatted in math mode. in math mode. Without math mode, 
Without math mode, we get we get at+b=b+a. And a+b=b+a 
atb=bta. And (Mit a+b=b+a} does not look much better. 


does not look much better. 
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Greek Symbols Marks Relations 
\alpha a \diamond o \geq > 
\beta B \triangleleft 4 \leq < 
\gamma y \triangleright > \neq x 
\delta 6 \cire o Min € 
\epsilon € \bullet e \subset C 
\pi T \ast * \subseteq C 
\Gamma r \cdot Other Symbols 
\Delta A Tli 

di Ellipses \cup U 
Delimiters \ldots T \cap n 
M 1 \cdots ee \sum X 
M } \vdots : \int f 


Figure 8.1 Control sequences for mathematical symbols. 


Displayed formulas can appear within paragraphs or between paragraphs. 
either case, they must be delimited by the double character ‘$$’ at their 


start and end points. 


be 
sp 
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Example of Source Text Corresponding Formatted Text 
The formula $$a(b-c) -a*b The formula 
-a*c$$ and the following 
formula are formatted in a(b—c) —-a*b—-a*c 
math mode. 
and the following formula are for- 
$$73-8-65$$ matted in math mode. 
Notice the indentations 73 —8 = 65 


after the formulas. 
Notice the indentations after the 


formulas. 


As in the typewriter font, in the math mode the characters ‘<’, ‘>’, and ‘ p 


have “normally”—that is, they produce the symbols ‘<’, ‘>’, and ‘|’, re- 
ectively. 

Example of Source Text Corresponding Formatted Text 
$a*a+1>0$ axa+1>0 


.2 Special Math Symbols 


Mathematics is a language that is very rich in symbols, and TẸX provides 
a large assortment of control sequences for accessing mathematical symbols. 


A 


in 


few of these control sequences and the symbols they represent are listed 
Fig. 8.1. 


8.3 SUPERSCRIPTS, SUBSCRIPTS, AND FRACTIONS 4T 


Example of Source Text Corresponding Formatted Text 
$\alpha \in \{0,1,\ldots\}$ a € {0,1,...} is a nonnegative inte- 
is a nonnegative ger number. 


integer number. 


The control sequences that access the mathematical symbols can be used 
only within math mode. However, the \ldots command has a countercom- 
mand \dots that can be used in ordinary mode. 


8.3 Superscripts, Subscripts, and 
Fractions 


4 
The math mode uses the special characters ‘~’ and ‘_’, respectively, to iden- 
tify superscripts and subscripts. within formulas. Specifically, it treats as a 
superscript a braced group that immediately follows a hat character, ‘~’, and 
it treats as a subscript a braced group that immediately follows an underscore 


character, ‘_’. The braces can be omitted when they delimit a single token. 
Example of Source Text Corresponding Formatted Text 
$x_{iti}=ax_itb*2$ 2,41 = az; +b? 


Superscripts and subscripts can themselves include superscripts and sub- 
scripts, and they can even form hierarchies of such entities. The subscripts 
and superscripts are for a group of symbols if they are preceded by a group. 
Otherwise, they are for a single symbol. 


Example of Source Text Corresponding Formatted Text 
$(d+1)*{2°{i-1}}$\par (d+ ONE 

$ (a^n) ^m$ \par (a")™ 

${(a°n) }"m$ (a^) 


A braced group of the form ‘{...\over...}’ denotes in math mode a 
vertical fraction in which the control sequence \over separates the numerator 
from the denominator. 


Example of Source Text Corresponding Formatted Text 
= a < 8-1 . 7 _ 
$18 1 Nover 35 21} 35-21 ^ 14 ^ 0.50 


={7 \over 14) = 0.50$ 


The braces can be omitted from ‘{...\over...}’ when the whole formula 
is a fraction. 
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Example of Source Text Corresponding Formatted Text 
The sum The sum )>;_,(%)* is equal to 
$\sum _{i=0} ^n =n 
({a \over b}) ^i$ 1- (a/b)^*! 
is equal to I- (a/b) 


$$1- (a/b)^int1] 
\over 1-(a/b)$$ 


8.4 Fonts 


The math mode employs fonts specially designed for mathematical formu- 
las. A user may switch to other fonts by inserting the appropriate control 
sequences. However, such switches apply only to letters and digits. 


Example of Source Text Corresponding Formatted Text 
$11 < \bf 111$ 11 < 111 and 111 < 1111 
and 


${\bf 111} < 1111$ 


Changes to fonts, variables, and other features within math formulas are 
local to the formulas. 


8.5 Spacings 


The math mode governs the spacing between the symbols, ignoring the con- 
tributions that the space characters make. 


Example of Source Text Corresponding Formatted Text 
$ one two \bf onetwoonetwo 
one two $ 


Yet, users can add spaces to formulas with the following control charac- 
ters: ‘\,’ (thin space), ‘\!’ (negative thin space), ‘\>’ (medium space), and 
';? (thick space). 


Example of Source Text Corresponding Formatted Text 
$-100\ ,000 —100 000 «< 1 << 100000 
«NNI 1 *'quote! within quote” 

<< 

100\,000$ \par 

“<$\,$ ‘quote’ 


within quote’? 
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Exercises | 

8.1.1 Write a source text for each of the following formatted texts. 
a. If 1.29- 0.33 = z, then z = 0.96. c.  Theinequality 
b. The sum 


(a+b)(a—b) >axa 


14+24+3+4+4+45 
dic holds for all b > 0. 


is equal to 15. 
8.2.1 Write a source text for each of the following formatted texts. 
a. The symbols a and f are Greek symbols. 
b. (1/2) + (1/4) + (1/8) +--+ <1 
{zle > 3)n {zz < 7} = {2|3 < z < 7) 
SOURCES OF ENERGY 


e Renewable 


e 


a. 


e Nonrenewable 


8.3.1 Write a source text for each of the following formatted texts. 


a. a? +b? =¢? c. $+ 5 = iibe 
— 94 n 
b. 2.2.2.2=2 d. ($P =% 


c. aa" +a”! +--+ anz =b 
39 _ 

d. 29. = 0.099 

8.5.1 Write a source text for the formatted text ‘Jæ + y| < |x + Iul. 
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Chapter 9 


FIGURES 


Two issues arise in dealing with figures: how to draw them and where to insert 
them. Drawing figures with TẸX is not an easy job unless we are dealing 
with textual figures or primitive drawings. Fancier figures must be drawn 
elsewhere, with the aid of external tools. However, TẸX is well equipped for 
allocating places for the figures. 


9.1 Floating Inserts 


Figures are treated as floating objects, in the sense that they need not be 
inserted at prespecified locations within the documents. The following two 
commands are offered for inserting figures into documents. 


o Ntopinsert(figure)Nendinsert 


This command inserts (figure) at the top of the current page. If (figure) 
does not fit in the current page, it is moved forward until it can be placed 
at the top of a page. 


o \pageinsert(figure)\endinsert 
This command inserts (figure) into a separate page. 


From the perspective of TEX, (figure) is the figure to be inserted into the 
document. In practice, however, each (figure) can be either an actual insertion 
generated by TEX or just a place holder produced with the command \vskip 
and filled by the user later on. The floating insertions should be introduced 
between paragraphs. 
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FLOATING INSERTS 51 
ee k 
ORR KK k k k E k k k 
ORR ak ok E ak ak k E RK k k k Æ 
Xkok ck k k k RK 
Example of Source Text ; Corresponding Formatted Text 
Find the figure. 4 Find the figure. 
\topinsert 


$$ oook $$ 

$$ soso $$ 
\vskip 0.4in 

$$ oaaao okk $$ 
$$ xoc $$ 
\endinsert 


TEX does not change the relative order of the floating insertions when it 


moves them to consecutive pages while it is looking for a place that they can 


fit 


in. The \supereject command can be used to insert a page break that 


forces the floating insertions out. 


The following command sets a maximum for the amount of space allo- 


cated within a single page for floating insertions. 


\dimen\topins=(dimension) 


Floating insertions are ignored within boxes (boxes are introduced in 


Chap. 10). 


Chapter 10 


COMPOUND UNITS 
OF TEXT 


The smallest imaginary rectangle that encloses an independent unit of text is 
called the bounding box of the unit of text, whereas an independent unit of 
text that is arranged into a rectangular area is called a box. For TEX, boxes 
are very important features, because TEX approaches the task of typesetting 
as a job of constructing boxes from boxes. In particular, from the perspective 
of TpX, the symbols are primitive boxes, the lines are compound boxes that 
are made up of primitive boxes that hold symbols and compound boxes that 
hold other things, and the pages are compound boxes that are made up of 
compound boxes that are lines. And the story does not end here, because 
TEX also treats figures and other entities like boxes. Yet, the users of TEX 
normally should not worry about boxes unless they want to devise some fancy 
features with these entities. 

The purpose of this chapter is to show how braced groups can be fixed 
into different kinds of boxes. The first section of this chapter considers basic 
definitions of boxes, the second looks at the benefit of having boxes within 
formulas, and the third shows how boxes with specific dimensions can be 
defined. The chapter concludes with a section that considers special effects 
with boxes. 


10.1 Boxes 


Braced groups and blocked groups can be viewed as passive groups, in the 
sense that they do not have any influence on their tokens. All they do is 
protect the outside world from changes that take place within their scope. 
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height 
fi 
codes — baseline 
point 
depth 


——— width —- 


Figure 10.1 Properties of boxes. 


The character ‘$’ and the double character ‘$$’, on the other hand, can 
be viewed as delimiters of active groups. Like the passive groups, these ac- 
live groups protect the outside world from changes that are made within the 
groups. But, in addition, these active groups offer a special environment to 
their tokens: an environment for typesetting math formulas. 

Boxes are another variety of active groups. They again protect the outside 
world from changes that are made within their scope. But instead of providing 
an environment for typesetting math formulas, they offer environments for 
typesetting given pieces of text into independent units of rectangular shape. 


External Views 


In horizontal mode (that is, within paragraphs), the boxes are treated 
by the outside world like big characters. They can be inserted at any place 
where characters can be inserted, and they cannot be broken between lines. 

In vertical mode (that is, between paragraphs), the boxes are treated by 
ihe outside world like lines. They can be inserted at any place where lines 
can be inserted, and they cannot be broken between pages. 

In either mode, the boxes are treated like rectangular regions that have 
baselines, widths, heights, depths, and reference points (see Fig. 10.1). 


Example. The baseline is highlighted for the following piece of text. 


wx Aab p} 


Types of Boxes 


Boxes that are placed side by side horizontally are aligned vertically so 
that their reference points, or equivalently their baselines, will fall on the same 
invisible horizontal line. Boxes that are placed vertically one on top of the 
other are aligned horizontally so that their reference points will fall on the 
same invisible vertical line. 
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Text can be typeset in boxes under conditions that apply to lines within 
paragraphs, or under conditions that apply to paragraphs within pages. Boxes 
that typeset their contents to the image of lines are called horizontal boxes, 
and boxes that typeset their contents to the image of paragraphs are called 
vertical boxes. 


Horizontal Boxes 


A horizontal box is an independent, nonbreakable rectangular area whose 
content is treated like a single line of text. A piece (teat) of text can be 
typeset into a horizontal box by applying the command \hbox on the braced 
group ‘{(tezt)}’. That is, ‘\nbox{(tezt)}’ produces a horizontal box with 
content (teat). 


Example of Source Text Corresponding Formatted Text 

The horizontal box \hbox{$A+0 The horizontal box A--0— A 
=A$} does not allow for line does not allow for line breaks within 
breaks within its content. its content. 


Boxes can appear anywhere, and can themselves be included within 
boxes. However, horizontal boxes can include only text that can appear within 
paragraphs. In particular, they cannot include end-of-paragraph indicators. 


Vertical Boxes 


A vertical box is an independent, nonbreakable rectangular area that 
contains paragraphs of text. The paragraphs are typeset to width \hsize. 
Local adjustments to the margins are determined by the variables \leftskip 
and \rightskip. The indentations at the start of the paragraphs are set 
through the variable \parindent. And so forth. 

Vertical boxes can be produced by commands that have the following 
forms. 


o \vbox{(tezt)}. This command typesets (tezt) into a vertical box and 
assigns to the box the same baseline as the one that is assigned to the last 
line within the box. 


Example of Source Text Corresponding Formatted Text 
Mparindent-Opt a bigger 
Add number. 


Add \vbox{\hsize=0.5in 
a bigger number.) 


When the vertical box is inserted into a line of text, the last line in the box 
is vertically aligned with the line that contains the box (see Fig. 10.2b). 
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(a) (b) (c) 


Figure 10.2 (a) Five lines of text. (b) \vbox inserted in the 
third line. (c) \vtop inserted in the third line. 


o \vtop{(tezt)}. This command typesets (tezt) into a vertical box and 
assigns to the box the same baseline as the one that is assigned to the first 
line within the box. 


Example of Source Text Corresponding Formatted Text 
Mparindent-Opt Add a bigger 
number. 


Add \vtop{\hsize=0.5in 
a bigger number.} 


When the vertical box is inserted into a line of text, the first line of the box 
is vertically aligned with the line that contains the box (see Fig. 10.2c). 


In general, paragraphs within vertical boxes are set to relatively small 
widths, making it harder for TX to break lines nicely. When TpX fails to 
produce nice line breaks, it issues the usual warning messages of ‘Overfull 
\hbox...’ and ‘Underfull \hbox...’. 


Boxes and Modes 


A box contributes an independent line if it is not inserted within a 
paragraph (that is, if it is inserted in vertical mode). Otherwise, it con- 
tributes to the text of a paragraph. The independent lines that the boxes 
contribute ignore the adjustments that are made to the margins with \left- 
skip and \rightskip. Similarly, these lines also ignore the indentations that 
\parindent requests. 


Example of Source Text Corresponding Formatted Text 
a\hbox{b} ab 
a 
\hbox{a}b b 
ab 


\leavevmode \hbox{a}b 
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If a box is encountered in vertical mode, TEX returns to vertical mode 
after processing the box. Similarly, if a box is encountered in horizontal mode, 
TEX continues in horizontal mode after processing the box. 


Example of Source Text Rome\hfill 54\par 


\parindent=0pt \leavevmode Sydney\hfill 74} 


\vbox{\hsize=0.7in 
\hfil $*\circ$F\par 


Lisbon\hfill 67\par Corresponding Formatted Text 

Oslo\hfill 39}\hfill oF Paris 49 
\vbox{\hsize=0.7in Lisbon 67 Rome 54 

Paris\hfill 49\par Oslo 39 Sydney 74 


Vertical mode and horizontal mode within a box are also referred to as 
inner vertical mode and inner horizontal mode, respectively. Initially, the 
inner vertical mode is in effect for a vertical box. 


10.2 Boxes within Formulas 


Boxes can appear within regular text and within formulas, but in either case 
they inherit the conditions that exist for regular text. 


Example of Source Text Corresponding Formatted Text 


$21 \hbox{ div } 5= 1$. 21 div 5 — 1. 21 div 5 — 1. 
Mt $21 \hbox{ div } 5- 1$. 
Since boxes do not inherit the conditions that exist for math mode, they 
can be used to insert regular text into mathematical formulas. 


Example of Source Text Corresponding Formatted Text 

$one two\hbox{ one twol$ onetwo one two 

$$\hbox{average} = { £d 
\hbox{sum of values) \over average = SA Or VETS 


\hbox{number of values} }$$ number of values 


The combination of math mode and boxes can also be used to achieve 
special effects in ordinary text. For instance, the combination can be used to 
produce displays of regular text. 


Example of Source Text Corresponding Formatted Text 
Background text. Background text. 
$$\hbox{CENTERED TEXT}$$ 

Again, background text. CENTERED TEXT 


Again, background text. 
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Boxes within formulas can themselves contain formulas. This is so be- 
cause the boxes ignore the conditions that the math mode implies for the 
formulas in which the boxes are embedded. 


Example of Source Text Corresponding Formatted Text 


$\{x|\hbox{value of $x$ {z|value of z is divisible by 2} 
is divisible by 2}\}$ 


10.3 Boxes of Specified Dimensions 


The command ‘\hbox{(tezt)}’ allocates to (tezt) a horizontal box of the width 
that is needed by (tezt). If the user wants to provide to (tezt) a box of width 
(dimension) that differs from the natural width, then he or she can specify 
the width explicitly in the manner ‘\hbox to (dimension){(teat)}’. 


Example of Source Text Corresponding Formatted Text 


-\hbox{a}-% -a-a -a -a -a 
\hbox to 1em{a}-% ' 

\hbox to 10mm{a}-¥ 

\hbox to iiníaj-a 


When a horizontal box is specified to have a width larger than the natural 
one, the spaces between the words and the sentences are stretched to fill the 
void. In addition, TEX issues the warning ‘Underfull \nhbox...’ if the spaces 
are overstretched. 


Example of Source Text Corresponding Formatted Text 
-\hbox to i0mmía b c}- -a b c- 

-a b c- 
-\hbox to iinía b c}- - a b c - 


~\hbox to iini a b c }- 


On the other hand, when the width to which a horizontal box is set is of 
insufficient magnitude, the text that does not fit into the box hangs beyond 
the end of the box. In such a case, TEX issues a warning ‘Overfull \hbox...’ 
which specifies the width of the hanging text. 

The text that succeeds a horizontal box is typeset starting from the (in- 
visible) point where the box ends. Hence, text that hangs beyond the end of 
a horizontal box overlaps with the text that follows the box. 


Example of Source Text Corresponding Formatted Text 


\noindent \tt /1114##== 
\hbox to 2em{///////}===== 
Like horizontal boxes, vertical boxes can either take their natural heights 
and depths as assigned to them by the commands ‘\vbox{(tezt)}’ and ‘\vtop{ 
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(tezt)}’, or have heights and depths of magnitude (dimension) assigned ex- 
plicitly by commands of the form ‘\vbox to (dimension) {(tezt)}’ and ‘\vtop 
to (dimension){(tezt)}’, respectively. 

For vertical boxes with explicitly specified heights and depths, TEX issues 
the messages ‘Overfull \vbox...’ and 'Underfull \vbox.. J when it cannot 
vertically fill the boxes in a nice manner. 


10.4 Text Justified within Boxes 


When TFX breaks paragraphs into lines, it typesets each line into a horizontal 
box whose width is equal to the width of the target line. This is the expla- 
nation for the \hbox in the ‘Underfull \hbox...’ and ‘Overfull \hbox...’ 
warning messages that TEX issues when it cannot typeset lines in a satisfac- 
tory manner. For the same reason, horizontal fillers within horizontal boxes 
behave the same way they behave within regular lines. That is, the horizontal 
fillers claim the extra spaces within the horizontal boxes for themselves and 
prevent annoying ‘Underfull \hbox...’ warning messages that result from 
voids in horizontal boxes. 


Example of Source Text Corresponding Formatted Text 
\parindent=-1.8em a. First paragraph. We labeled this 
\leftskip=1.8em \leavevmode paragraph with (a). 

\hbox to 1.8emía. hfillA b. Second paragraph. 


First paragraph. We labeled 
this paragraph with (a). 


\leavevmode 
\hbox to 1.8em{b.\hfil}% 
Second paragraph. 


When TFX breaks documents into pages, it typesets the body of each 
page into a vertical box whose height is equal to the value of \vsize. Hence, 
the behavior of the vertical fillers \vfil and \vfill in vertical boxes can be 
deduced from their behavior within pages. 


Example of Source Text Corresponding Formatted Text 
\parindent=0pt \leavevmode TEX 
\vbox to 1in{\hsize=0.9in Executive 
\vfil \hfil HELP\par HELP 
\hfil WANTED\vfil} WANTED 
\vbox to iin{\hsize=0.9in C 


\hfil \TeX\par 
\hfil Executive\vfil 
\hfil C\par 

\hfil Programmer} 


Programmer 


10.5 OVERWRITING AND INVISIBLE TEXT 
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10.5 Overwriting and Invisible Text 


Working with boxes can be quite a finicky job, but in some cases we may be 
wiling to make the effort in order to get special effects. In such cases, the 
following variants of horizontal boxes may come in handy. 


o \rlap{(tezt)}. This command writes (tezt) over the text that succeeds 


the command. 
Example of Source Text 


Stretched\hfill paragraph. 


A \rlap{=====}canceled word. 


\hfill\rlap{Text in margin.} 


Corresponding Formatted Text 


Stretched 
A canceled: word. 


paragraph. 


The command sets a horizontal box of width 0 pt that contains (tezt) and 
that does not cause a warning message. The text (tezt) hangs beyond the 
end of the box and overlaps the text that succeeds the box. 


o \llap{(tezt)}. This command writes (tezt) over the text that precedes the 
command. It does so by setting a horizontal box similar to ‘\rlap{(tezt)}’, 
with the only difference being that (tezt) hangs to the left of the box 
instead of to its right. Hence, (tezt) overlaps the text that precedes the 


box. 
Example of Source Text 
$$\rlap{aaa}\llap{bbb}$$ 


\leftskip=2em 

\noindent \llap{$\circ$ }% 
Text. More text. Again 
text. Enough text. l 


\noindent \llap{$\circ$ }% 
\TeX{} puts the circle 
in the left margin. 


Corresponding Formatted Text 


bbbaaa 


o Text. More text. Again text. 
Enough text. 

o TEX puts the circle in the left 
margin. 


o \phantom{(tezt)}. This command claims the space that (tezt) requires, 
without inserting (tezt) into the document. It does this by setting an 
empty horizontal box of the same size as ‘\hbox{(tezt)}’. 


Example of Source Text 


1\phantom{234}56 \par 
1\phantom{23}456 \par 
1\phantom{2}3456 \par 
123\phantom{4}56 \par 
12\phantom{345}6 


Corresponding Formatted Text 


1 56 
1 456 
1 3456 
123 56 
12 6 


Text in margin. 
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Unlike the command ‘\hbox{(tezt)}’, the command ‘\phantom{(tezt)}’ 
does not treat ‘{(tezt)}’ as a braced group. Instead, the braces are con- 
sidered to be delimiters for the parameter (tezt). 


Like the \hbox, \vbox, and \vtop commands, the above commands claim 
full lines for themselves when they are encountered in vertical mode. 


Exercises 


10.1.1 Write a source text for the following formatted text. 
abc abc 
defghi defghi 
jkimno jklmno 
pqrstu Ppqrstu 

vWXyzZ abcvwxyz abc 

defghi defghi 

jkl mno jklmno 

Pqrstu pqrstu 

vWXxyz vVWXyzZz 


10.2.1 Write a source text for each of the formatted texts below. 
a. {n|n is divisible by 2) is the set of even numbers. 
b. We can use math mode with boxes to raise text and to lower text. 


10.4.1 Write a source text that produces the following formatted text. 


Units Cost 
15 9.99 
123456 6543.21 


10.5.1 For each of the following cases, write a source text that produces the 
formatted text. 


a. An equality. b. G 
R 
14+2+4+3=6 GREEN 
E 
Another equality. N 


10 + 20+ 30 = 60 
And yet another equality. 


8=2+24242 


TeX AS A 
PROGRAMMING 
LANGUAGE 


Chapter 11 


MACROS 


We give names to people, streets, countries, books, songs, trees, and so on and 
on and on. We do so because names let us express ourselves more efficiently. 
In the case of TEX, we can assign names to pieces of text and then refer to 
the pieces of text indirectly through the names. The named pieces of text are 
called macroinstructions, or just macros. 

Those of us who have some background in programming will realize that 
macros provide to TEX what procedures provide to some other programming 
languages—the ability to work with abstractions. Intuitively, a macro, like a 
procedure, has a name, a body, and possibly some parameters. However, here 
the similarities end, because with a procedure a reference to its name causes 
the execution of its body, whereas with a macro a reference to its name results 
in the replacement of the name with the corresponding body. 

This chapter consists of seven sections that deal with basic aspects of 
macro definitions and usages. The first section introduces parameterless 
macros, and the second generalizes into parametric macros. The third sec- 
tion considers some restrictions for macros, whereas the fourth looks at how 
macros are expanded. The fifth section addresses the scope of definitions, the 
sixth examines nested definitions, and the last offers debugging tools. 


11.1 Parameterless Macros 


Macros give us the means for defining new commands. New commands, in 
turn, help us reduce the amount of effort that we need to put into the doc- 
uments that we prepare. Normally, the new commands make TEX a more 
user-friendly system, they eliminate repetitive jobs, and they maintain uni- 
formity within documents. 
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TEX offers very powerful macro mechanisms. The simplest definition of 
a macro takes the following form. 


\def (macro name) {replacement tezt)} 


In this definition, (macro name) must be a control sequence, and (replacement 
tezt) can be almost any piece of text. 


Example of Source Text Corresponding Formatted Text 
\def\srs{saurus} Albertsaurus, Allosaurus, 
Albert\srs, Allo\srs, Apatosaurus, Anatosaurus, 
Apato\srs, Anato\srs, Ankylosaurus. 

Ankylo\srs. 


A definition of a macro assigns a name to a piece of text. Thereafter, the 
name serves as a command that produces the piece of text. The piece of text 
is called the body or the replacement text of the macro. 


Example of Source Text Corresponding Formatted Text 
\def\\{{\tt \char 92}} The control symbol \\ produces the 
, The control symbol \\\\ . symbol \. 


produces the symbol \\. 


When we define new commands, we must be aware that lowercase and 
uppercase letters are considered to be different letters. When we use the new 
commands, we must recall that control words absorb the space characters that 
succeed them. 


Example of Source Text Corresponding Formatted Text 
\def\x{lowercase} UPPERCASElowercase 
\def\X{UPPERCASE} \X \x 


The replacement text of a macro can contain names of other macros. 
Therefore, a reference to a macro can result in indirect references to additional 
macros. 


Example of Source Text Corresponding Formatted Text 
\def\can{ can catch } I can catch a mouse, a mouse can 
\def\mouse{a mouse} catch me. 


\def\catch{I\can \mouse, 
\mouse\can me.) \catch . 


We can also have recursion with macros; that is, we can have macros that 
directly or indirectly refer to their own names. And if we are careless, we can 
even end up in infinite loops (which can be aborted by pressing ‘control-c’ 
on the keyboard). 


Example of Source Text 


\def\inf{\inf} \inf 
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Macros allow us to expand the base system with commands that are 
tailored to meet our own needs. And in fact, the more sophisticated users we 
become, the more we rely on commands that we define. 


Example of Source Text Corresponding Formatted Text 

\def\Claim{\begingroup We can define environments for 
\medskip \bf Claim. \it} claims. 

\def\EndClaim{\medskip Gina Macios ame piahi. 
\endgroup} 

We can define environments And we can make claims. 


for claims. \Claim Macros 
are powerful. \EndClaim 

And we can make claims.\Claim 
Macros are useful. \EndClaim 


Claim. Macros are useful. 


TEX offers a large assortment of commands. Some of the commands 
are primitives and some are nonprimitives. The nonprimitive commands are 
macros that are defined within TEX. For instance, \empty, \space, \bye, 
and \TeX are nonprimitive TeX commands. The \empty command carries 
the definition ‘\def\empty{}’, and the \space command carries the definition 
‘\def\space{ P. 


11.2 Parametric Macros 


Some commands of TEX, like \rm and \par, are parameterless commands. 
Others, like ‘\phantom{(tezt)}’, are parametric commands. The macros that 
we considered in the previous section allowed us to define parameterless com- 
mands. In this section, we look at macros that define parametric commands. 

Parameterless macros substitute their names for their bodies. Parametric 
macros do a little more than that. They replace their names and some of the 
text that follows their names with a composition of their bodies and the text 
that they consume. ; 


Structure 
The parametric macros are defined in the following manner. 
\def (macro name) (formal parameters) {(replacement tezt)) 


In the definition of a macro, the component (formal parameters) stands 
for ‘#1’, for ‘#1#2’, for ‘#1#2#3’,..., or for ‘#1#2#3 ---#9’. Each of the entities 
‘#1’,...,‘#9° in the definition is a formal parameter, or a name of a parameter, 
of the macro. 

The body (replacement tezt) in the definition of a parametric macro is 
similar to that in the definition of a parameterless macro, with the only ex- 
ception that now the body may also refer to formal parameters that are listed 
in the (formal parameters). 
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Example. The definition ‘\def\same#1{#1}’, which uses one parame- 
ter, and the definition ‘\def\average#1#2{$#1+#2 \over 2$}’, which 
uses two parameters, are proper definitions. 


The definition ‘\def\oooops#1{#2}’ is improper because the formal 
parameter ‘#2’ appears in the body without being listed before the 
left brace character. Similarly, the definitions ‘\def\oops#2{}’ and 
‘\def\ooops#2#1{} are improper because they have improper lists of 
formal parameters. 


Parameters introduce flexibility to macros because their values affect the 
outcome of the macros. A reference to an n-parametric macro takes the 
following form. 


(macro name){(actual parameter,)} ---{(actual parametern)} 


A component (actual parameter;) of a reference to a parametric macro is 
said to be an actual parameter, or the value of a parameter, or an argument 
of the macro. 


Example. The token list ‘\x{aa}{bb}’ is a proper reference to a macro 
Xx that has the definition ‘def\x#1#2{...}’. On the other hand, 
‘\x{aa}’ and ‘\x{aa}{bb}{cc}’ are improper invocations of the macro, 
because the number of actual parameters in the references to the macro 
differ from the number of formal parameters in the definition of the 
macro. 


The ith actual parameter (actual parameter;) of an invocation to a macro 
is associated with the ith formal parameter ‘#7’ of the macro. 


Meaning 


TEX replaces each reference to a parametric macro with the body of the 
macro, and it replaces each appearance of a formal parameter ‘#2’ in the body 
of the macro with the ith actual parameter (actual parameter;) of the macro. 


Example of Source Text Corresponding Formatted Text 
\def\game#1{I #1 the game.) I won the game. I two the game. I 
\game{won} \game{two} three the game. ... I ate the game. 
\game{three} $\ldots$ 

\game{ate} 


In each invocation of a parametric macro, the name of the macro is 
assumed to be followed by the actual parameters. The actual parameters can 
consist of almost any text, but each of the actual parameters must be enclosed 
between braces. 
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Example of Source Text Corresponding Formatted Text 

\def\like#1#2{#1 likes #2, Amy likes Dave, and Dave likes Amy. 
and #2 likes #1.} Bebe likes Nino, and Nino likes Bebe. 

\Like{amy}{Dave} i 

\like{Bebe}{Nino} 


In an exception to the above rule, the braces that enclose the actual 
parameters are optional when the actual parameters consist of just a single 
token. For such cases, we should recall that TEX has only two kinds of tokens: 
control sequences and characters. 


Example of Source Text , Corresponding Formatted Text 
\def\duplicate#i{#1#1}\par aabaabc 

Mduplicate[aab)c \par aac 

\duplicate ac \par aa’ 


$\duplicate \alpha*\beta$ 


The braces that enclose the actual parameters do not belong to the actual 
parameters. Therefore, when the actual parameters are substituted for the 
formal parameters, the braces do not appear in the substitutions. 


Example of Source Text Corresponding Formatted Text 


\def\Exp#1{e7#1} e20 £ e? 
$\Exp{20} \neq \Exp{{20}}$ 


Macros can be defined to have at most nine parameters. Yet indirectly 
they can employ more than this number of parameters. 


Example of Source Text {15}{16}{17}{18}{19}{20}{21} 


\def \Sum#1#2#3#4#5#6{$ 
#1+#2+#3+#4+#5+#6+\xSum} 
\def \xSum#1#2#3#4#5#6{ 
#1+#2+#3+#4+#5+#6 $} 10 4- 11+12+13+14+15+16+ 
NSum(10H 11H 121 (13H14) 17 4 18+ 19+ 20 4- 21 
Macros let us write at abstract levels that better fit our tasks and tastes. 
In addition, they allow us to share pieces of text among different parts of a 
document. 


Corresponding Formatted Text 


Example of Source Text Corresponding Formatted Text 
\def \add#1{\rlap{#1}\hfill} NAME AGE CITY 
\def \tb1#1#2#3{\par\noindent Dan 8 El Xxx 
\add{#1}\add{#2}\add{#3}} Ron 49 La Yyy 
\tbl{NAMEHAGEHCITY} — : Steve 101 Beth Zzz 


\tbl{Dan}{8}{E1 Xxx} 
\tbl{Ron}{49}{La Yyy} 
\tb1{Steve}{101}{Beth Zzz} 
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11.3 Two and a Half Restrictions 


Some restrictions apply to macro definitions and usages. In most cases, the 
restrictions that apply to braces, end-of-paragraph indicators, and space char- 
acters are the only ones that matter. 


Braces 


The braces, ‘{’ and ‘}’, are allowed within replacement texts and actual 
parameters. However, they must be well balanced there. 


Example of Source Text Corresponding Formatted Text 
\def\Exp#1{e*{#1}} e?0 — 220 
$\Exp{20} = \Exp{{20}}$ 

Paragraph Breaks 


In their default form, macros do not allow paragraph breaks within their 
actual parameters. This default property can be changed for a macro by 
inserting the control sequence \long as a prefix to the definition of the macro. 


Example of Source Text Corresponding Formatted Text 
\long\def \a#1{#1} as 
\a{aa \par bbb bbb 
cc dd 
cc dd} 


Space Characters 


There are no restrictions on space characters within replacement texts 
and actual parameters. Moreover, the space characters are ignored before 
braced and nonbraced actual parameters. 


Example of Source Text Corresponding Formatted Text 


\def\x#1#2{.#1.#2.} .a.b. .aa.bb. 
\x ab \x {aa} {bb} 


On the other hand, space characters assume special meaning within the 
list (formal parameters) of formal parameters in a macro definition. Therefore, 
space characters should be avoided in such lists until their meaning there is 
understood (see Sec. 15.4). 


11.4 How Macros Are Expanded 


A reference to a macro results in the replacement of the reference with the 
body of the macro. Each reference to a macro in the body, in turn, is replaced 
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with its corresponding body. And the process goes on until no more references 
to macros are left. This whole process is called the expansion of the macro. 

Whenever two or more references to macros are present simultaneously, 
the leftmost reference is the one that is processed first. 


Notation. In what follows, (token list;) = (token list2) denotes a 
single "step" of an expansion that goes from (token lisi;) to (token 
list ;). i 


Example. Consider the following definitions. 


Mdef M (0) 

\def\2{\1\1} 
\def\4{\2\2} 
\def\8{\4\4} 
\def\F{\8\8} 


With these definitions we get the following expansion for ‘\F\F ps’. 


\F\F ps => \8\8\F ps 
=> \4\4\8\F ps 
=> \2\2\4\8\F ps 
=> \1\1\2\4\8\F ps 
= o\1\2\4\8\F ps 
=> 00\2\4\8\F ps 
= 00\1\1\4\8\F ps 


> 0000000000000000000000000000000\1 ps 


> 00000000000000000000000000000000p8 


When parametric macros are invoked, the actual parameters are substi- 
tuted for the formal parameters in the replacement texts before any expansion 
takes place. 


Example of Source Text 

\def \exchange#1#2{#2#1} 

\exchange {\exchange ab} {\exchange c\exchange } 
Corresponding Expansion 


\exchange {\exchange ab} {\exchange c\exchange } 
=> \exchange c\exchange \exchange ab 
=> Vexchange c \exchange ab => \exchange c ab = acb 
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11.5 Scope of Definitions 


Different macros can be defined for a given control sequence, but only the 
most recent definition counts when the control sequence is encountered. 


Example of Source Text Corresponding Formatted Text 
\def\use{Using the \th Using the first definition. Using the 
definition.} second definition. 


\def\th{first ) \use 
\def\th{second } \use 


Definitions of macros within groups persist only until the groups reach 
their ends. That is, the definitions are local to the groups. 


Example of Source Text Corresponding Formatted Text 


\def\where{out} {\where? out? in out. 
\def\where{in} \where} \where. 


A definition within a group can be made global by inserting the command 
\global as a prefix to the definition. The control sequence \gdef serves as a 
shorthand way of writing ‘\global\def’. 


Example of Source Text Corresponding Formatted Text 


\begingroup Everywhere. Everywhere. 
\gdef\where{Everywhere. } 
\where \endgroup \where 


In dealing with the scope of definitions, we should notice that groups can 
take different forms. They can be defined by braces, they can be defined by 
the control sequences \begingroup and \endgroup, they can be defined to be 
in the form of formulas, they can be defined to be in the form of figures, and 
they can be defined to be in the form of boxes. 


11.6 Nested Definitions 


No restrictions are placed on where macros can be defined. Such a freedom 
allows more flexible control over the placement of definitions. But, at the 
same time, it also demands more sophistication from the users. 


Example of Source Text Corresponding Formatted Text 
\def\a{A} \def\h{h\def\afa}} Ah, ah. 
\a\h, \a\h. 


Definitions that appear in the bodies of macros can be a major source of 
confusion. This is so because the definitions are inserted indirectly into the 
text. That is, they are hidden definitions. 
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Example of Source Text Corresponding Formatted Text 
\def\oh{Oh\def\oh{oh}} © Oh, oh, oh, oh. 
\oh, \oh, \oh, \oh. : 


Nested definitions can be parametric, and so can the macros that con- 
tain them. Parametric macros with nested definitions require extra caution, 
because as well as hiding definitions they may also hide transfers of text. 


Example of Source Text Corresponding Formatted Text 
\def\remove#1{\def\add{#1}} bea 
\remove abc\add 
Definitions of macros can be nested to levels higher than one. And here we 
might get into tricky worlds that can be quite complex (and even undesirable). 
Example of Source Text 
\def\next{\xcount} 
\def\xcount{one% 
\def \next{two% 
\def\next{three’, 
\def\next{\xcount}}}} 


\next, \next, \next, \next, \next. 


Corresponding Expansion 
\next, \next, \next, \next, \next. 
=> \xcount, \next, \next, \next, \next. 
=> one\def\next{two\def\next{three\def\next{\xcount}}}, 
\next, \next, \next, \next. 
=> one, two\def\next{three\def\next{\xcount}}, 
\next, \next, \next. 
— one, two, three\def\next{\xcount}, ware \next. 
=> one, two, three, \xcount, \next. 
> one, two, three, 
one \def \next{two\def \next{three\def\next{\xcount}}}, \next. 
=> one, two, three, 
one, two\def\next{three\def\next{\xcount}}. 


=> one, two, three, one, two. 


Parametric Macros. 


The formal parameters of nested parametric macros must take the forms 
“##1’, “H#2’,... instead of the forms ‘#1’, ‘#2’,..., respectively. 
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Example of Source Text Corresponding Formatted Text 
\def \R{\def \s##1##2##3[##3 Her I love, loves me she, and in love 
##1 ##2}} we are. 
\def\L{\def \s##1##2##3{##2 
##3 ##1}} 


AR \s{I}{love}{Her}, - 
AL \s{she}{loves}{me}, 
and \s{we are}{in love}{}. 
Like external definitions, nested definitions of macros are restricted to 
nine parameters. 


Example of Source Text \AB\x{XXXX} {xxxx} 
\def\ShowTitle{\det\pe#it}y,  \ShowTitle\x, \ShowBody\x. 

\def\A##1{##1}} 
\def \ShowBody{\def\a##1{}7% 

\def NBI (HEY) ; 

FK tted Text 
Mlef MBit 14283] Corresponding Formatted Tex 
\def#1{\A{#2}\B{#3}}} XXXX, xxxx. 


Different notations are needed for formal parameters of level one and for 
formal parameters of level two, to allow for the coexistence of the parameters. 


Example of Source Text Corresponding Formatted Text 
\def \a#i{\def\b##1##2{##1 I love her, you love him, we love love. 

#1 ##2}} He met him, she met her, they met 
\a{love} \b{I}{her}, theirs. 


\b{you} {him}, \b{we}{love}. 
\a{met} \b{He} {him}, 
\b{she}{her}, \b{they}{theirs}. 


In general, parametric macros that are defined inside £ levels of macros 
must refer to their formal parameters with names of the form ‘#-- d? that 
contain 2t characters ‘#’. 


Example of Source Text Corresponding Formatted Text 
\def\a#i{\def \b##1{% AA11. AA22. 
\def \c####1{% 
Sid SB 1)3) 


Na(AA) \b{.} \c{11} \c{22} 
11.7 Debugging Corner 


The following are three useful commands for tracking macros. 


o \meaning(macro name). This command shows, in the formatted text, the 
definition of the macro whose name is provided. 


EXERCISES 


Example of Source Text 


{\tt \meaning\bye } \par 


\def\\#1{{\tt\char92 #1}} 
\\fouter} says that 
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Corresponding Formatted Text 


\outer macro:->\par \vfill 
\supereject \end 


\outer says that \bye cannot be 


\\f{bye} cannot be l 
embedded within a body or 
an actual parameter of a 
macro. \\{end} is a weaker 
variation of \\{bye}. 


embedded within a body or an ac- 
tual parameter of a macro. \end is 
a weaker variation of \bye. 


o \immediate\write16{\meaning(macro name)}. This command shows, 
on the terminal and in the log file, the definition of the macro whose name 
is provided. 

o \show(macro name). This command shows, on the terminal and in the 
log file, the definition of the macro whose name is provided. In addition, 
the command prompts the user for directions. i 

o \tracingmacros=1. Expansions of macros that occur after the execution 
of this command are traced within the log file. The command ceases to take 
effect when the end of a group that contains the command is reached. The 
tracing can also be terminated with the command ‘\tracingmacros=0’. 


+ 


Exercises 


11.1.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text Formatted Text 


A \txt. Same \txt. And 
more of the same \txt. 


A piece of text. Same piece of text. 


And more of the same piece of text. 
b. Source Text ; Formatted Text 


Each <macro name> offers a <re- 
placement text>. 


Each \<macro name\> offers 
a \<replacement text\>. 


c. Source Text Formatted Text 


List of items. List of items. 
\Olist \item First item. o First item. First item. First 
First item. First item. item. 
\item Second item. l o Second item. 
\item Third item. o Third item. 
\EndOlist No more items. 
No more items. l 
11.1.2 Define a macro named \newpage that inserts a page break at the 


locations where the command appears. 
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11.2.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text 
\ir{regular} Mrírelevant) 
\irfresistible} 

b. Source Text 


\SubSet{1,3,5,\ldots} 
{1,2,3,\ldots} 


c. Source Text 


\def\gobble#1{} 
\a{Abridge} M (Abroad) 
\a{Around} 


d. Source Text 


\noindent\vtop{\hsize=1in 
\letter{Anna}{Sept .26}} 

\ \ \ \vtop{\hsize=1in 
\letter{Dan}{Oct. 3}} 


e. Source Text 


\def\row#1#2#3#4{\par 
\noindent \bx{#1i}% 
\bx{#2}\bx{#3}\bx{#4}} 


\row{Length}{Width}{Area}{P} 


\row{2}{4}{8}{12} 
\row{31}{25}{775}{112} 
\row{11}{9}{99}{40} 


f. Source Text 


\card{30pt} \card{15mm} 
\card{0.8in} 


Formatted Text 


Irregular regular. Irrelevant rele- 
vant. Irresistible resistible. 


Formatted Text 
{1,3,5,...} C {1,2,3,...} 


Formatted Text 


Abridge bridge. Abroad broad. 
Around round. 


Formatted Text 
Dear Anna, Dear Dan, 
Happy Birthday. Happy Birthday. 
Love, A and B. Love, A and B. 
Formatted Text 


Length Width Area P 


2 4 8 12 
31 25 775 112 
11 9 99 40 


Formatted Text 


o o oo 0 OO o o 
ooo 
o O 
o 00 le] [e] [e] 
Oo oO O 
o [e] o 


11.3.1 Write the necessary macros so that the source text will expand to the 


formatted text. 


Source Text 


\two{1. 


}{2. \par}\two{0ne, }{two}. 


Formatted Text 


1. 
2. 
One, two. 
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11.4.1 Show the expansion of \F with the following definitions. 


\def \F{\4\8} \def\4{\1\2} \def\if{o} 
\def\8{\2\4} \def\2{o\1} 


11.4.2 Find and explain the outcome of the source text ‘\def\x{\chari2} 
\x 0 Nx. 


11.4.3 Show the expansion of 
\exchange {{\exchange ab}} {\exchange c\exchange } 


for the definition that is given to \exchange in Sec. 11.4. 


11.5.1 Write the necessary macros so that the source text will expand to the 
formatted text. 


Source Text Formatted Text 
\begingroup xx 
\def\b{\a} 
\gdef\c{\b} 
\endgroup 
\c 


11.6.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text Formatted Text 
\plus $3 \op 2 \op 1=6$, 34+241=6,3-2-1=0. 
\minus $3 \op 2 \op 1=0$. 
b. Source Text Formatted Text 
\plus $\op51=6$, $Vop21-3$, 5+1=6,2+1=3,124+3=9, 
$\op{12}{3}=9$, 21 — 7 = 14, 33 — 17 = 16. 


\minus $\op{21}{7}=14$, 
$\op{33}{17}=16$. 


Chapter 12 


DATA TYPES 


From a microscopic point of view, TEX deals with tokens that are either 
control sequences or characters. From a macroscopic point of view, however, 
it also works with other kinds of data. Specifically, TEX also works with token 
lists, integers, and dimensions. 

In earlier chapters, we got some glimpses into the role that token lists, 
integers, and dimensions play in TgX. The current chapter studies these data 
types more thoroughly. The three data types are considered in the first three 
sections. The concluding section introduces debugging tools. 


12.1 Token Lists 


A token list is a sequence of tokens in which the braces are well balanced. 
Bodies of macros and actual parameters are just two examples of such data 
elements. 

Normally, programming languages let their users introduce variables for 
storing data elements. "With such a mission, the variables acquire a role 
similar to that of macros. That is, they serve as couriers for information. As 
a result, the variables encourage the sharing of text, they promote more user- 
friendly environments for writing, and they promote uniformity throughout 
the documents. 

TEX is no exception in this regard. It lets us define variables for its data 
elements. In particular, for token lists, the definitions take the following form. 


\newtoks (variable) 


The variables (variable) must be control sequences, and the definitions 
initialize the variables to hold an empty token list. Each such variable can be 
directly assigned a token list by a command of the form 


(variable)={(token list)} 
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or be indirectly assigned the token list that another variable holds by a com- 
mand of the following form. 

(target variable)=(source variable) 


On the other hand, the content of a variable can be extracted by a command 
of the following form. 


\the(variable) 
Example of Source Text Corresponding Formatted Text 
\newtoks\a \a={one} one, two, one, two. 
\newtoks\b \b={two} 
\newtoks\save 
\def\next{\the\a 


\save=\a \a=\b \b=\save} 
\next, \next, \next, \next. 


The \the command extracts the content of the given variable. Once the 
content of the variable has been exposed, it is treated like any other source 
text. i 


Example of Source Text Corresponding Formatted Text 


\newtoks\a xx 


\a={\def\b{xx}\b} \the\a 


Variables that are defined with the command \newtoks are called vari- 
ables of type token list. Such variables can hold only data elements that are 
token lists. 


Example of Source Text f Corresponding Formatted Text 


\newtoks\a X y, y. 
\a={x \a={y} \the\a} 
\the\a, \the\a. 


The equality character, ‘=’, is optional within the assignment commands. 


Scope i 

Changes made to the values of the variables are local to the group in which 
the changes are being made. The changes can be made global by inserting the 
control sequence \global before the assignment instructions. On the other 
hand, the \newtoks command has global scope. 


Example of Source Text Corresponding Formatted Text 


{\newtoks\x . local global 
\global\x={global} 
\x={local} \the\x } \the\x 
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Predefined Variables 


The following are some variables of type token list that are predefined in 
TeX. 
o \headline. Whenever TpX is ready to ship out a new page, it inserts the 
content of this variable into the header (see Sec. 6.1). The header is a 
horizontal box of size \hsize. 


o \footline. This variable is used in the footer, in a manner similar to the 
way that \headline is used in the header (see Sec. 6.1). 


o Veverypar. Whenever TeX encounters a new paragraph, it inserts the 
content of this variable into the start of the paragraph. 


Example of Source Text Corresponding Formatted Text 
\everypar={$\bullet$ } e Out 
\par Out \par Out e Out 
\begingroup o In 
\everypar={ $\circ$ ) o In 
\par In \par In e Out 
\endgroup \par Qut 


o \output. Whenever TpX finds the boundaries of a new page, it executes 
the instructions that are found in this variable. These instructions deter- 
mine how the pages should be delivered into the formatted documents. 


12.2 Integers 


Within documents, we use the integers for counting pages, chapters, items of 
lists, and other textual entities. In TEX, integer constants take the common 
form of sequences of digits that may be preceded by the ‘-’ sign. A variable 
for holding such constants can be defined by a command of the following form. 


\newcount (variable) 


Each variable (variable) must be a control sequence. The command \new- 
count initializes the variables to 0. A variable can be directly assigned a value 
by an instruction of the form 


(variable)- (sign) (integer constant) 
or be indirectly assigned a value by an instruction of the form 
(target variable)- (sign) (source variable) 


where (sign) is optional and stands for an arbitrary number of minus charac- 
ters ‘~’. 
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On the other hand, the content of a variable can be extracted by a com- 
mand of the following form. 


\the(variable) | 
Example of Source Text Corresponding Formatted Text 
\newcount\c \the\c, 0, -1, 1. 


\c=-1 \the\c, \c=-\c \the\c. 


An odd number of minus characters in (sign) is equivalent to a single mi- 
nus character, and an even number of minus characters in (sign) is equivalent 
to empty (sign). 


Example of Source Text Corresponding Formatted Text 


\newcount\c \c=-5 \c=--\c -5, 5. 
\the\c, \c=---\c \the\c. l 


Operations 


Now that we know how to get and use variables for transferring integer 
values around the documents, we should turn our attention to learning how 
such values can be manipulated. After all, what good will the integer values 
do us if we cannot even use them for counting one, two, three...? 

- Fortunately, operating on integers is quite an easy job with the following 
commands that 'TEX offers. The commands are primitive in nature, but they 
support well the needs of text formatting. 


\advance (variable) by (integer) 
\multiply (variable) by (integer) 
\divide (variable) by (integer) 


The commands manipulate the values that are stored in the integer vari- 
ables (variable), and they have the obvious meaning. An integer division is 
assumed for the last command, and each (integer) stands either for an integer 
constant or for a variable name that is optionally preceded by a sign. 


Example of Source Text Corresponding Formatted Text 


\newcount\a \a=3 3*(-3) div 2 = -4 
\multiply \a by -\a 

\divide \a by 2 ; 

$3*(-3)\hbox{ div }2=\the\a$ 


In most cases, TpX does not care whether integer values are provided 
directly through constants or indirectly through variables. 
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Example of Source Text Corresponding Formatted Text 
\newcount\x \newcount\y 11 e ° 
\def\DrawPoint#1#2{% 


\rlap{\vbox to #2em{% 
\hsize=#1em #2\hfill 
$\bullet$\vfil 6 e e 
\hfill #1}}} 
\def\point{\advance\x by 2 
\y=\x \advance Vy by -8 2 
\multiply Vy by Vy 
Nadvance Vy by 10 
\divide Vy by 4 
\DrawPoint{\the\x}{\the\y}} 
\noindent \point \point \point 
\point \point \point \point 


2 4 6 8 10 12 14 


The scoping rules for the changes that are made to the values of the 
variables of type integer are similar to those that apply for the variables of 
type token list. In particular, changes that are made to the variables within 
a group persist only until the end of the group. However, the changes can be 
made global with the \global command. 


Example of Source Text Corresponding Formatted Text 


{\newcount\x \global\x=5 75 
\advance \x by 2 
\the\x } \the\x 


Numbering Systems 


Normally, we use the Arabic numbering system for displaying integer 
values. We can use the \the command to extract the values from the variables 
in such a format. 


Example of Source Text Corresponding Formatted Text 
\leftskip=2em \parskip=0em 1. I’m thankful for life. 
\newcount \c 2. I’m thankful for food. 
\everypar={\advance\c by 1 3. I’m thankful for all the nice peo- 
\llap{\the\c. 3% ple around me. 
I’m thankful for } 4. I'm thankful for having a good 
\par life. \par food. school. 
\par all the nice people 5. I’m thankful for a family. 


around me. 
\par having a good school. 
\par a family. 
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As well as the Arabic numbering system, we also use the alphabetical 
numbering system extensively. We encounter alphabetical numbers on license 
plates of cars, on items in enumerated lists, and in other places. Alphabetical 
numbers can be produced with the \char command. 


Example of Source Text Corresponding Formatted Text 
\newcount\x \x=96 a. Shoe. 
\def\boo#i{\advance\x by 1 b. Clue. 

\par \char\x. #1.} c. Zoo. 
\boo{Shoe} \boo{Clue} d. Who. 


\boo{Zoo} \boo{Who} 


The Roman numbering system is not as popular as the two other systems, 
but still it has many applications. The command \romannumeral can be ap- 
plied on integer values to obtain the corresponding lowercase roman numerals. 
The command provides an empty string for 0 and for negative values. 


Example of Source Text Corresponding Formatted Text 
\newcount\x iii, vi, ix, xii, xv, xviii, xxi, xxiv. 
\def\c{\advance\x by 3 

\romannumeral\x} \c, 


\c, \c, \c, \c, \c, \c, \c. 
Predefined Variables 


The following are six variables of type integer that are predefined in TEX. 


9 Npageno. Initially this variable holds the value 0. As with other variables, 
the user can set \pageno to any desired value. However, whenever TEX 
is about to submit a new page to the formatted document, it modifies 
the value of \pageno. TpX increases the value of \pageno by 1 if the 
variable holds a nonnegative value. Otherwise, TEX decreases the value of 
the variable by 1. 


\time, \day, \month, Vyear. At the start of a compilation, TEX sets the 
obvious values in these variables. 


o 


o \inputlineno. During the scanning of a given input file, TeX records in 
this variable the number within the file of the line that it scans. TEX does 
not allow the users to assign values to this variable. 


Word of Caution 


Like control words, integer constants absorb the space and end-of-line 
characters that succeed them in the input lines. However, unlike the case 
with the control words, in the case of integer constants, TEX accumulates into 
ihe constants not only digits that it explicitly finds in the inputs but also 
digits that it encounters as it expands the inputs. 
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Example of Source Text Corresponding Formatted Text 
\newcount\c \def\x{5} \c=1 215 
\c=2\the\c \x\relax \the\c 

Variants 


The equality characters, ‘=’, are optional within the assignment instruc- 
tions, and the keywords ‘by’ are optional within the arithmetic operations. 


Example of Source Text Corresponding Formatted Text 


\newcount\c \ci4 4 
\divide\c3 \the\c 


12.3 Dimensions 


We can express dimensions with the unit systems of inches (in), millimeters 
(mm), points (pt), ems, and exs (see Sec. 5.1). Among these unit systems, 
points have the highest resolution and are the ones that TpX uses for express- 
ing itself. 


Rigid Dimensions 
Variables for holding dimensions can be defined by commands of the form 
\newdimen( variable) 


where each (variable) must be a control sequence. The variables \hsize, 
\vsize, \hoffset, \voffset, and \parindent (see Fig. 6.1) are examples of 
variables of this type that are predefined in TpX. 

The \newdimen command initializes the variables to hold the value Opt. 
Each variable can be directly assigned a value by an instruction of the form 


(variable)=(sign)(dimension constant) 
or be indirectly assigned a value by an instruction of the form 
(target variable)=(sign) (decimal number) (source variable) 


where (sign) and (decimal number) are optional and carry the obvious mean- 
ing. 

The content of a given variable can be extracted by a command of the 
following form. 


\the(variable) 
Example of Source Text Corresponding Formatted Text 
\newdimen\c \c=10in 722.7pt, 284.52756pt. 


\the\c, \c=100mm \the\c. 
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In the latter instruction, ‘(decimal number) (source variable)’ stands for 
the product of the constant (decimal number) with the value of the variable 
{source variable). 


Example of Source Text s Corresponding Formatted Text 


\newdimen\c \c=11.ipt | -9.98993pt 
\c=-0.9\c \the\c 


Arithmetic operations similar to those that are offered for the integers 
are also offered for dimensions. 


\advance (variable) by (dimension) 
\multiply (variable) by (integer) 
\divide (variable) by (integer) 


Example of Source Text i Corresponding Formatted Text 


\newdimen\d \d=5pt i 21.37032pt 
\advance\d by 5in j 

\advance\d by -0.3\d 

\divide\d by 12 \the\d — 


Computations that are made with dimensions have limited accuracy, and 
they can introduce small errors. 


Example of Source Text Corresponding Formatted Text 


\newdimen\c \c=800pt 0.07991pt 0.08002pt 
{\c=0.01\c \c=0.01\c \the\c} 
\c=0.1\c \c=0.1\c \c=0.1\c 
\c=0.1\c \the\c 
Variables that hold dimensions can appear at any location where dimen- 
sions are required. i 


i 
Example of Source Text i Corresponding Formatted Text 


\def\four#1#2{\hsize=#1 FO UR 
\vtop to \hsize{#2}} 
\four{0.69in}{FO\hfill 


. R 1 
UR\vfil COR\hfill NERS} CORNERS 


The scoping rules for variables that hold dimensions are similar to those 
for variables that hold token lists and integers. That is, changes made to the 
variables within a group are local to the group. The changes can be made 
global by the \global command. 


Conversions to Integer and Decimal Values 


Variables that hold integer values can be assigned values from variables 
that hold dimensions. However, in such cases, the integer variables do not get 
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the obvious values that are stored in the dimension variables. Instead, the 
integer variables receive the integer portions of the products of 65536 with 
the values that are stored in the dimension variables. 


Example of Source Text Corresponding Formatted Text 
\newcount\c \newdimen\d 5.0pt, 5, 25.0pt. 

\d=5pt \c=\d \the\d, 

\divide\c by 65536 \the\c, 

\d=\the\c\d \the\d. 


The following example introduces a definition for producing decimal num- 
bers from dimensions that are stored in variables. The definition relies on 
features that will be discussed in future chapters. 


Example of Source Text \decimal\d, \d=\decimal\d\d 
\def\x{\catcode‘\p=12 \decimal\d, 
\catcode‘\t=12} \advance\d by\decimal\d\d 
\decimal\d. 


\def\y{\catcode‘\p=11 
\catcode‘\t=11} 
\x \def\dec#ipt{#1} \y 
\def \decimal#1{\expandafter 
\dec \the#1} 
\newdimen\d \d=0.5pt 0.5, 0.25, 0.3125. 


Corresponding Formatted Text 


Flexible Dimensions 


Sometimes we are allowed to specify flexible dimensions, also called glues. 
A glue gives a natural length and limits for stretching or compressing the 
natural length when such a need arises. A glue has the form 


(natural dimension) plus (stretchability) minus (compressibility) 


where ‘plus (stretchability)’ and ‘minus (compressibility)’ are optional. The 
components (natural dimension), (stretchability), and (compressibility) stand 
for rigid dimensions. 

Variables for holding glues are defined by commands of the following 
form. 


\newskip(variable) 


The variables can be processed by commands that are similar to those 
offered for the variables that hold rigid dimensions. However, only the natural 
parts of the glues are considered when they are multiplied by constants. 


Example of Source Text Corresponding Formatted Text 


\newskip\c 72.26999pt minus 2.84526pt 
‘\c=1in minus imm \the\c 
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The variables \leftskip, \rightskip, \baselineskip, and \parskip 
are examples of predefined variables (see Fig. 6.1) that hold values of type 
glue. 


Example of Source Text huge, funny, long books that 


\def\centered{\parindent=0pt have stretchy, ard: words: 


\leftskip=0pt 
plus 0.5\hsize 


\rightskip=\leftskip Corresponding Formatted Text 


\par} I used to think that it was 
\centered I used to think impossible to read big, fat, books 
that it was impossible to with ten pages or more. But now I 
read big, fat, books with think anyone can read huge, funny, 
ten pages or more. But now long books that have stretchy, hard 
I think anyone can read : words. 


The commands \hskip and Nvskip are examples of commands that 
can use glues. The variants \smallskip, \medskip, and \bigskip of the 
command \vskip refer to predefined variables Nsmallskipamount, \med- 
skipamount, and \bigskipamount, respectively, of type glue. 


Example of Source Text Corresponding Formatted Text 
{\tt \meaning\medskip } macro:->\vskip \medskipamount 
\par\the\medskipamount 6.0pt plus 2.0pt minus 2.0pt 


To facilitate the manipulation of spaces, TpX introduces the variable 
\lastskip, which holds the size of the space in the last contributed token. 


Dimensions of Boxes 


Each box has width, height, and depth (see Fig. 10.1). TX offers the 
following commands and variables which can be used to determine these char- 
acteristics of boxes. 


o \setbox0=(boz). This command records the given box (boz) in a special 
box variable that has the index 0. 


o \ht0. This variable holds the height of the box that is stored in the box 
variable that has the index 0. 


Example of Source Text Corresponding Formatted Text 
\setbox0=\hbox{\tt x} 4.30554pt 6.11111pt 
\newdimen\D \D=\ht0 \the\D 

\setbox0=\hbox{\tt abc} 

\the\hto 3 


o XdpO. This variable holds the depth of the box that is stored in the box 
variable that has the index 0. 
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o \wd0. This variable holds the width of the box that is stored in the box 
variable that has the index 0. 


Example of Source Text Corresponding Formatted Text 
\vtop{\tt \setbox0= ABCDE 
\hbox{A B C D E) FGHIJ 
\hsize=\wd0 KLMNO 
\parindent=0pt PQRST 
ABCDEFGHI UVWXY 
JKLMNOPQR Z 


STUVWX Y Z} 


12.4 Debugging Corner 


The following commands write the values of the specified variables to the 
terminal and to the log file. In addition, the second command prompts the 
user for directions. 

o \immediate\write16{(variable)=\the(variable)} 


o \showthe(variable) 


Exercises 


12.1.1 TX predefines variables named \everymath, \everydisplay, \ev- 

eryhbox, and \everyvbox. Can you figure out how TEX uses these variables? 

12.1.2 Define a variable named \text of type token list and a macro named 

\dotext that upon invocation produces the content of \text. 

12.1.3 For each of the following cases, set \everypar so that the specified 

conditions will hold. 

a. The odd paragraphs adjust their right margin one inch inward, whereas 
the even ones adjust their left margin one inch inward. 

b. The odd paragraphs start with indentations of Opt, and the even ones 
start with indentations of 20pt. 

c. The odd paragraphs start with indentation of 20pt and no adjustment 


to their margins. The even paragraphs start with negative indentation of 
20pt and adjust their margins 20pt inward. 


12.2.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text Formatted Text 
\boo{Blue} \boo{Flew} (A) Blue. (A) Flew. (B) View. 
\boo{View} \boo{Cue} (B) Cue. (C) New. (C) You. 
\boo{New} \boofYou} (D) Few. (D) Two. (E) Sue. 


\boo{Few} \boo{Two} \boo{Sue} 
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b. Source Text : Formatted Text 
\addroman{50}{100} | lt+e=d 
\addroman{40}{90} xl + xc = cxxx 
\addroman{449}{999} cdxlix + emxcix = mcdxlviii 

c. Source Text Formatted Text 
\a\i, M, M, \a\i, \i, * a.1, a.2, a.3, b.1, b.2, c.1, c.2, c.3. 


\a\i, M, M. 


12.2.2 (Spreadsheet) Give the necessary definitions so that the source text 
will produce the formatted text. 


Source Text {Earned}{Spent}{Total} 
\def\ShowLn#1#2#3#4{% —. \Addin{Jan 90}{93}{41} 
\noindent\rlap{#1}\hfill \AddLn{Jun 90}{391}{431} 
\hfill\llap{#2} \AddLn{Feb 91}{701}{273} 
\hfil2\llap{#3} \total 
\hfill1\llap{#4}\par} 
\def \AddLn#1#2#3{%, 
\cale{#2}{#3} Formatted Text 
\ShowLn{#1}{$#2$} Date Earned Spent Total 
{$#3$}{$\the\D$}} Jan 90 93 41 52 
\def\total{\ShowLn{Total} Jun 90 391 431 —40 
{\the\a}{\the\B}{\the\c}} Feb 91 701 273 428 
\noindent \ShowLn{Date} Total 1185 745 440 


12.3.1 Define a macro \hugeskip that inserts vertical space. The ratio be- 
tween the amounts of space that \hugeskip and \bigskip insert should be the 
same as the ratio between the amounts of space that \bigskip and \medskip 
insert. 


12.3.2 Write a macro \raggedright that makes the right margins flexible. 
Specifically, the macro should allow for local inward adjustments to the right 
margins in the range of Opt to 0.5\hsize. 


12.3.3 What does the command ‘\hskip ~\lastskip’ do in vertical mode? 
What does ‘\vskip -Mlastskip! do in horizontal mode? 


12.3.4 Explain the following source text. 


\newdimen\wa \newdimen\wb \newdimen\wc 

\def\setwidth#1#2{\setbox0=\hbox{#2}¥%, 
#1=\wd0} 

\def \setrow#1#2#3{\setwidth\wa{#i}% 
\setwidth\wh{#2}% 
\setwidth\wc{#3}} 

\def \row#1#2#3{\noindent 
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\hbox to \wa{#1\nfil}Y 

\hbox to \wb{#2\hfil}% 

\hbox to \wc{\hfil#3}\par} 
\setrow{Home Runs xxx}{Henderson xxx}{4444 xxx} 
\row{Steals}{Henderson}{939} \row{Hits}{Rose}{4192} 
\row{Home Runs}{Aaron}{715} \row{Runs}{Cobb}{1737} 


12.3.5 Use the following equality to define a command for dividing decimal 
numbers. 


a _ integer part(a) « 1000 + integer part (fraction part(a) + 1000) 


b integer part(b) « 1000 + integer part (fraction part(b) + 1000) 


12.4.1 Find the width, height, and depth of the characters ‘a’, ‘b’, ‘p’, ‘C, 
and ‘.’ in roman font and in typewriter font. 


Chapter 13 


SELECTORS 


Sophisticated applications test the conditions that exist during the processing 
of the text, and proceed according to the outcome of the tests. The first section 
of this chapter shows the structure of some commands that test conditions 
and make selections. The other five sections specify conditions that can be 
tested. l 


` 


13.1 General Form 


The commands that we consider in this chapter select a piece of text from a 
given set of options. The commands make the selection based on the outcome 
of some conditions that they check. These commands are called selectors, or 
branching commands, and they take the following form. 


\if (condition) (true part)\else(false part)N£i 


The ‘\if(condition)’ determines the condition to be tested. When the 
condition holds, (true part) is selected and (false part) is ignored. Otherwise, 
(false part) is selected and (true part) is ignored. The control sequence \else 
is optional when (false part) is empty. 

Selectors can be nested within the true and false parts of other selectors. 
The nesting can be explicit or implicit. When the nesting is implicit, the 
nested selectors can be embedded within macros or within variables. 


13.2 On Integers 


The ‘\if(condition)’ can take the following form when the conditions to be 
tested are concerned with integer values 


\ifnum(integer) (relation) (integer) 
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where (relation) stands for ‘<’, ‘=’, or ‘>’. 


Example of Source Text Corresponding Formatted Text 
\def \max#1#2{\ifnum#1>#2 100 

#1\else #2\fi} 
\max{10}{100} 


Similarly, for integer values, the ‘\if(condition)’ can also take the fol- 
lowing form. 


\ifodd(integer) 
Example of Source Text Corresponding Formatted Text 
\newcount\c 0.5, 1. 


\def \half#i{\c=#1 
\divide Nc by 2 \the\c 
\ifodd #1 .5\fi} 
\half{i}, \half{2}. 


The \ifnum and \ifodd commands can directly or indirectly be nested 
within the true and false parts of selectors. 


Example of Source Text \x{11}{12}, \x{13}{13}, 


\def\x#1#2{% \x{15H14}. 
\ifnum #1<#2 
#1, #2\else 
\ifnum #1=#2 #1\else 
#2, #1\fi 
\fi} 11, 12, 13, 14, 15. 


Corresponding Formatted Text 


In addition, the commands can be completely or partially embedded 
within macros and variables. 


Example of Source Text Corresponding Formatted Text 
\def\ifpositive{\ifnum 0<} 33 positive, —33 not positive. 
\def \check#1{$#1$ 

\ifpositive #1 

positive\else 


not positive\fi} 
\check{33}, \check{-33}. 


Manner of Processing 


After encountering the control sequence \ifnum or the control sequence 
\ifodd, TgX expands the text that succeeds the control sequence. The ex- 
pansion continues until the expression ‘(integer) (relation) (integer)' or the ex- 
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pression (integer), respectively, gets exposed. Then TEX checks the condition 
and continues according to the case. 


o 


o 


The condition is true. The text that succeeds the condition is expanded 
and retained until a \fi or an Velse is reached. In the latter case, the text 
that succeeds the \else is consumed and disposed of without expansion 
until a \fi is encountered. 


The condition is false. The text that succeeds the condition is consumed 
and disposed of without expansion until a \fi or an \else is reached. In 
the latter case, the text that succeeds the \else is expanded and retained 
until a \fi is encountered. 


Example of Source Text 


\def \gobble#1{} 

\def \neg#1{#1<0 } 

\def\abs#1{\ifnum \neg{#1}\gobble #1\else #1\fi} 
\abs{-10}, \abs{10} 


Corresponding Expansion 


\abs{-10}, \abs{10} 

=> \ifnum \neg{-10}\gobble -10\else -10\fi, \abs{10} 
= \ifnum -10<0 \gobble -10\else -10\fi, \abs{10} 

=> \gobble -10\else -10\fi, \abs{10} 

= 10\else -10\fi, \abs{10} 

= 10, \abs{10} 

= 10, \ifnum \neg{10}\gobble 10\else 10\fi 

= 10, \ifnum 10«0 \gobble 10\else 10\fi 

=> 10, 10\fi í 

= 10, 10 


In general, the \if(condition)’s, \else’s, and \fi’s of nested selectors 


are matched together and do not interfere with the process that matches the 


\i 


f(condition)'s, \else’s, and \fi’s of the selectors that contain them. 


Example of Source Text \c= 7000 \x, \x, \x, \x. 
\newcount\c \c=-7000 \x, \x, \x, \x. 
\def\x{% 
\ifnum \ifnum\c<0-\fi 
\c>10 ? 


Corresponding Formatted Text 
\divide \c by 10 p £ 


\fi  $\the\c$} 700, 70, 7, T. —700, —70, —7, —7. 
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However, if portions of the nested selectors do not get exposed because 
they appear implicitly within macros or variables, then such interference can 
occur. 


Example. The following source text works fine as long as \c does not 
carry the value 0. However, TEX complains about an extra \fi when 
\c carries such a value because TX does not see the control sequence 
\ifnum within the definition of \ifpos. 


\newcount\c \def\ifpos{\ifnum 0<} 


\ifnum \c=0 zero 
\else\ifpos \c positive 

\else negative 
\fi Mi 


When TẸX constructs an integer constant, it assembles as many digits as 
it can reach by scanning the input and by expanding the tokens. It terminates 
the construction when it encounters a nonexpandable token that is not a 
digit. Therefore, integer constants under construction do not have effect on 
the outcome of tests that are performed by selectors. 


Example of Source Text Corresponding Formatted Text 


\newcount\c , 50. 5, 5. 
\def\check{\ifnum \c=0 

O\else 5\fi, \the\c} 
{\c=5\check}. \c=5 \check. 


Recursive Macros 


Conditional commands allow us to introduce halting conditions for re- 
cursive macros, that is, for macros that directly or indirectly call themselves. 


Example of Source Text \fi} 


\newcount\c $\fact 4$ 


\def\fact#1{\c=#1 
Mifnum \c=0 1 
\else \the\c{} * 
\advance Nc by -1 
\fact \c 4*x3*x2*1*1 


Corresponding Formatted Text 


Recursive macros can be very demanding of memory, because each level 
of recursion may claim memory for itself. However, recursive macros do not 
require extra amounts of memory when they use tail recursion. 
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Example of Source Text Corresponding Formatted Text 
\newcount\c The following are the symbols in the 
\def\symbol{\advance \c by 1 italic font: AOAEUOYTEVN 

\ifnum \c=128 FAAfifie, 777 ° fee 

\def\next{\relax}/, OHED-!"#L%8B'() t+, 

\else\ \char\c Mi . ./0123456789:;;j—4? 

\next} GABCDEFGHIJKLMN 
MdefNnextiNsymbol) 0 PQRSTUVWXYZ[*]* 
The following are the LH d 
symbols in the italic stuvweyz-— 


font:{\it \symbol}. 


Recursive processes that use tail recursion are transformed by TẸX into 
iterative processes. 


Example of Source Text \Dof{-1}{5}{:\the\c:{ 
\Do{\the\c}{6}{\the\c}} }// 


\newcount\b \newcount\c 

\def\Do#1#2#3{\c=#1 \b=#2 

\def\next{\ifnum \c>\b- 
\def\next{} \else 

#3 \advance\c by 1 \fi 78 / +1: -10123456 :0: 0 


Corresponding Formatted Text 


\next} 123456 :1: 123456 :2: 
\next} 23456 :3: 3456 :4: 456 
\Do{7}{8}{\the\c}/ 65: 56 // 
A Variant 


For the integers, we can also use selectors of the following form. 


\ifcase(integer)(parto)\or ---\or(party_1)\or 
(part,)\else(else part)\fi 


A selector of this form produces (tezt;) when (integer) = iand 0 < i< n. 
Otherwise, the selector produces (else part). 


Example of Source Text Y\or Z\else ?\fi} 

\def\Alph#i{\ifcase #1 \Alphi, \Alph2, \Alph{30} 
?\or A\or B\or C\or D\or 
E\or F\or G\or H\or I\or 
J\or K\or L\or M\or N\or 
O\or P\or Q\or R\or S\or 
T\or U\or V\or W\or X\or A, B,? 


Corresponding Formatted Text 


The ‘\else(else part)’ portion is optional when (integer) is guaranteed 
to hold a value between 0 and n. 
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Example of Source Text \Define\yi{#i\x} 

\ifcase#2 \def#1{#3}% \z{10}{20} 

\or \def#1##1{#3}% 

M \dettine1#e2tea y Corresponding Formatted Text 
\Define\x0{; } 20; 10; 


13.3 On Dimensions 
For dimensions, ‘\if(condition)’ can take the following form. 
\ifdim(dimension) (relation) (dimension) 


The \ifdim is used on dimensions in a manner similar to the way that 
its counterpart \ifnum is used on integers. 


Example of Source Text \row{Fruits}{3.08}% 
\det \row#1#2{#1\hfill \row{Bread}{1.64}END} 
#2\break 


\setbox0=\hbox{#1#2xx}% 


\ifdim \hsize<\wd0 Corresponding Formatted Text 


\hsize=\wd0 Mil Vegetables 3.96 
\parindent=0em Fruits 3.08 
\vbox{\hsize=0em Bread 1.64 

\row{Vegetables}{3.96}% END 


13.4 On Tokens 


Characters and control sequences are the only tokens of TgX. Some of the 
control sequences are expandable and some are not. 


Nonexpandable Tokens 
To test conditions on tokens, ‘\if(condition)’ can take the following form. 
\if (nonezpandable token) (nonezpandable token) 


The two tokens are tested for equality. They are considered to be equal if 
either of the following conditions holds. 


a. The two tokens are two characters with identical character codes. 


b. The two tokens are control sequences. 
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Example of Source Text Corresponding Formatted Text 


\if ab Yes\else No\fi, No, yes. 
\if\def\par yes\else no\fi. 


As with \ifnum, \ifodd, \ifdim, and \ifcase, in the case of \if, the 
text that succeeds \if is expanded until the arguments get exposed (that is, 
until two nonexpandable tokens get exposed). 


Example of Source Text Corresponding Formatted Text 


\def\a{x} \def\b{\a} 1 
\if\a\b 1\else 2\fi 


Expandable Tokens. 
For tokens, ‘\if(condition)’ can also be of the following form. 
\ifx(token) (token) 


This command tests the equality of the pair of tokens that succeed \ifx 
without letting them expand. The tokens are considered to be equal if they 


carry the same meaning. 
E] 


Example of Source Text Corresponding Formatted Text 


\def\afa} \def\b{a} \def\c{b} 1 
\ifx \a\b 1\fi \ifx \a\c 2\fi 


The meaning of a token is the definition that is given to the token, not 
the outcome of the expansion of the token. Two tokens can expand to the 
same text, yet have different meanings and so be considered unequal by \ifx. 


Example of Source Text Corresponding Formatted Text 


\def\a{x} \def\b{\a} 2 
\ifx\a\b 1\else 2\fi 


The \ifx command is an important feature for controlling recursive pro- 
cessing of text and for defining commands with a flexible number of parame- 
ters. , 


Example of Source Text Corresponding Formatted Text 
\def\x#1{\def\y{\z}% one; two; 1; 2; 3; 4; 5; 
\y#1{}} 


\def\z#i{\def\temp{#1}¥, 
\ifx \temp\empty \def\y{} 
\else #1; Mi — Vy) 

\xffone}{two}} \x{12345} 
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13.5 On Modes 


The selectors that we considered in the previous sections test for conditions on 
data elements. The selectors that are introduced in this section are concerned 
with testing for the mode of TpX. 


Math Mode 


To check whether TpX is in math mode, ‘\if(condition)’ can take the 
form \ifmmode. 


Example of Source Text in math mode and two dots 
\def\twodots{’%, \twodots{} in regular mode. 


\ifmmode \cdot\cdot 


\else $\cdot\cdot$\ti} Corresponding Formatted Text 


{\tt\char92 cdot} must \cdot must appear in math mode. 
appear in math mode. Here Here are two dots -- in math mode 
are two dots $\twodots$ and two dots -- in regular mode. 


Horizontal and Vertical Modes 


To check whether TpX is in horizontal mode or in vertical mode, the 
command ‘\if (condition)! can take the form Vi fhmode or the form Mif vmode, 
respectively. 


Example of Source Text Corresponding Formatted Text 
\def\FindMode{\ifvmode V mode. 

\hbox{V mode. }\else V mode. 

\hbox{H mode. }\fi} H mode. H mode. 


\par \FindMode \FindMode 
\leavevmode\FindMode\FindMode 
Inner Mode 


TX is considered to be in inner mode when it processes text within a 
box. To check for this mode, ‘\if(condition)’ can take the form \ifinner. 


Example of Source Text Corresponding Formatted Text 
\def\a{\ifinner In\else Out. In. Out. 
Out\fi} Na. \hboxf{\a}. Na. 


13.6 On Boolean Switches 


A user can also tailor conditions to be tested by employing Boolean switches. 
Specifically, a definition of the form 


\newif \if (switch) 
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with (switch) standing for an arbitrary nonempty string of letters, allows 
‘\if (condition)’ to take the form ‘\if(switch)’. 

The definition implicitly introduces the control sequences ‘\ (switch) true’ 
and ‘\(switch)false’ for setting the switch to true and false values, respec- 
tively. Initially, the switch gets the false value. 


Example of Source Text . Corresponding Formatted Text 


\def\a{\ifon On\onfalse Off. On. Off. On. 
\else Off\ontrue\fi} 
\newif\ifon \a. \a. \a. \a. 


Changes to the values of the switches are local to the groups that contain 
them. They can be made global with the \global command. 


Example of Source Text Corresponding Formatted Text 
\newif\ifon {\ontrue} 2, 1. 

\ifon i\else 2\fi, 

{\global\ontrue} 


\ifon 1\else 2\fi. 


Exercises 


13.2.1 Write a macro \mult that implies the formatted text for the source 
text. ; l 


Source Text ' Formatted Text 
\mult 2{32}{14}\par 2 hours 32 minutes 14 seconds 
\mult 00{12}\hfill \mult000 12 seconds 0 hours 


13.2.2 Write a macro that accepts an integer constant or an integer variable 
for an actual parameter, and inserts the absolute value of the actual parameter 
into the formatted text. 

13.2.3 Identify the problem that arises when ‘\abs{-10}’ is expanded ac- 
cording to the following definitions. 


\gobble#i{} \def\neg#i{#1<0 } 
\def\abs#1{\ifnum \neg{#1}\gobble\fi #1} 


13.2.4 Determine the outcome of the following source text. 


\newcount\c \divide\c by 2 
\def\loga#1{\c=#1 \def\next{\logB\c} 
\ifnum \c>1 : \the\c 
\divide\c by 2 \else 
\logA\c \the\c Mil \def\next{\relax} 
\def\logB#1{\c=#1 \fi \next} 


Mifnum \c>1 \logA{4096} \logB{4096} 
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13.3.1 The following equalities are known to hold for the trigonometric func- 
tions sin(z) and cos(z), respectively. In the equalities, x is assumed to be the 
number of degrees times 3.14/180. 


: z? a5 

sin(z)-2— qp tup t 
227 zt 

ace apte 


The next piece of code uses the definition of Ndecimal from Sec. 12.3 to 
compute the function sin(z). Modify the code to compute the function cos(z). 


Example of Source Text \def\Sin#i{\def\next{\xSin} 
\x=#1pt \x=3.14\x 
\divide\x by 180 
\c=1 \d=\x \s=\d 
\next \the\s} 

\sin{0} \Sin{22.5} \sin{45} 

\sin{67.5} \Sin{90} 


\newdimen\x \newcount\c 

\newdimen\d \newdimen\s 

\def \xSin{\d=\decimal\x\d 
\d=-\decimal\x\d 
\advance\c by 1 
\divide\d by\c 
\advance\c by 1 
\divide\d by\c 
\advance\s by\d 
\ifdim \ifdim\d<Opt-\fi 

\d<0.00ipt \def\next{}  0.0pt 0.38249pt 0.70682pt 

\fi \next} 0.92366pt 1.00002pt 


Corresponding Formatted Text 


13.3.2 Define a command that computes the square root yc for any given 
decimal number c. The following equalities offer an approximation 2,41 to Ve; 
where the accuracy of the approximation increases with n. 


13.4.1 Explain the following macros. 


\def\OpenGroup#i{\begingroup 
\def \GroupName{#1}} 

\def \CloseGroup#1{\def\Name{#1}% 
\ifx \GroupName\Name \endgroup 
\else ERROR \fi} 
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13.4.2 Explain the meaning of the macro \x that is defined below. 


\def\EqInt#i#2{xx\fi \ifnum #1=#2} 
\def\EqText#1#2{xx\fi \def\a{#1}\def\b{#2}% 
\ifx \a\b} 
\def\then{\relax} 
\def \x#1#2#3{\def\next{}¥ 
Mf \EqInt{#1}{#2}\then 
Mf \EqText{#1}{#2}% 
\def \next{#3}% 
\fi\fi  \next} 
13.4.3 Write a one-parameter macro that determines whether given control 
sequences are undefined. 
13.5.1 Write a macro \frac that implies the formatted text for the source 
text. 


Source Text Formatted Text 


\frac{12}{17}, and 12/17, and H, 
$\frac{11}{19}$. 


13.5.2 Write a macro named \newmedskip that acts like \medskip in hor- 
izontal mode. In vertical mode, the macro should check the amount of ver- 
tical space that the last token inserted. If the amount is smaller than \med- 
skipamount, the macro should add the amount of space needed to reach the 
magnitude of \medskipamount. 


Chapter 14 


AUXILIARY FILES 


Auxiliary files are used for breaking documents into parts and for communi- 
cating information. This chapter consists of three sections. The first section 
shows how auxiliary files can be incorporated into a source document, and 
the second and third show how information can be read from and written into 
auxiliary files, respectively. 


14.1 Importing 


Working with large files can be quite a time-consuming process. Recording 
changes made to large files requires a great deal of computer time, and pro- 
cessing large files into formatted documents also requires a great deal of time. 

Splitting large files into smaller ones can help overcome these problems. 
With smaller files, changes made to the files are recorded faster. And when 
the files are compiled, the compilation may be restricted to those files that 
have been changed. 

We can assemble large TEX documents from small files, by employing 
commands that have the following form. 


\input (filename) 


A command of this form requests that TEX process the text in the aux- 
iliary file (filename) before processing the text that succeeds the command. 

A large source document can be made up from a small root file using 
\input commands to incorporate other files. These other files, in turn, can 
themselves incorporate additional files with \input commands. And so forth. 

In each \input command, the name (filename) must be succeeded by at 
least one space character and must conform with the rules of the system in 
use. 
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Example. The author uses a system in which the names have the 
form ‘a.@’, where the extensions *.9* can be ignored within the \input 
commands if they are equal to ‘.tex’. 


If ‘fileA.tex’ is the name of a file that has the content ‘aa \input 
fileB cc ’ and ‘fileB.tex’ is the name of a file that has the content 
‘bb ’, then the source text ‘\input fileA dd’ produces the same result 
as the source. text ‘aa bb cc dd’. 


14.2 Reading 


Some auxiliary files may hold text that needs to be spread through the source 
document, not just being imported as a single continuous chunk of text. Other 
auxiliary files may hold text that needs to be processed before being imported 
into a document. In either case, the contents of the files must be retrieved 
piecewise. 


TEX provides 16 buffers, numbered 0 to 15, for reading auxiliary files 


piecewise. The following are the commands that are provided for such a task. 


[*) 


o 


\openin(buffer)=(filename). This command initiates the input file for 
reading via buffer (buffer), and it temporarily appends an empty line to 
the end of the file for the period of time that the buffer is associated with 
the file. If the input file does not exist, an empty file is associated with the 
buffer. (The extension of the filename can be omitted if it equals *. tex.) 


\closein(buffer). This command frees input buffer (buffer) from being 
associated with any input file. 


\read(buffer) to(control sequence). This command reads the next line 
from the input file of buffer (buffer), and defines a parameterless macro 
whose name is (control sequence) and whose body is the line of text that 
has been read. 


If the input line contains braces in unbalanced form, the succeeding input 
lines are read and appended to the original line until the braces become 
balanced. 


If there is nothing left in the input to be read, TEX waits for an input line 
from the terminal. 


\ifeof(buffer)(true part)\else(false part)\fi. This selector checks 
whether buffer (buffer) has reached the end of the input file, and acts 
accordingly. 
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Example of Source Text Corresponding Formatted Text 
\def\next{\ifeof15 THE END **aaaaa 

\else \readi5 to\x \x\fi} **aa 
** \input yy.tex ** aaa 


\openini5=yy \next \next 
\next \next \next \closeini5 


A source document does not have to reach the end of an input file to 
obtain an input directly from the terminal. Instead, the source document 
can use the command \read16 for such a purpose (or \read with any other 
integer number that is bigger than 15). 


Example of Source Text Corresponding Formatted Text 
\def\get{\readié6 to Nx \x} My 1, 1111 

\get l \medskip Hi There: 

Hi \get: \medskip Here is my first letter to you. 
Here is my first 

letter to you. \medskip Regards; 

Regards, \medskip \get Yours 


For names of nonexisting files, the \openin command associates empty 
files with the buffers. For names of existing files, the command associates 
nonempty files with the buffers. Consequently, the command can be employed 
to check whether given names refer to existing files. 


Example of Source Text Corresponding Formatted Text 


\openini5=no.file No Yes 
\ifeofi5 No \else Yes \fi 

\closeini5 \openini5=yes.file 
\ifeof15 No \else Yes \fi 

\closeini5 


Users do not have to be concerned with the bookkeeping chores of allo- 
cating buffers. The command ‘\newread(control sequence)’ can be used to 
automatically reserve an unused input buffer and to record the index of the 
buffer in (control sequence). 

Automatic reservations are preferable to manual ones because they offer 
protection against conflicting assignments of buffers. In addition, indirect 
references to the buffers through control sequences make the source documents 
more readable. 


Example of Source Text 


\newread\inbuff \openin\inbuff=yy 
\read\inbuff to \x \closein\inbuff 
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An input file can be accessed simultaneously via different buffers that act 
on the file independently. 


14.3 Writing 


Macros and variables are two useful mechanisms for transferring information 
around the documents. However, they are limited with respect to the amount 
of information that they can transfer, and they cannot be used to transfer 
information backwards. These shortcoming can be resolved with the help of 
auxiliary files that are prepared during the compilation of a document. 

Special commands and buffers can be used for writing into output files, 
just as they were used in the previous section for reading from auxiliary files. 
Specifically, in addition to the 16 buffers that are available for the input files, 
there are 16 buffers available for the output files. The output buffers are 
numbered 0 to 15. The commands that are available for writing output files 
are the following variants of the commands that are available for reading input 
files. 


o Nopenout(buffer)-(filename). For the output files, the names must be 
fully given with their extensions. 


o Ncloseout(buffer). 


o \write(buffer){(token list)). This command writes the expansion of the 
given (token list) into the output file. The nonexpandable tokens in (token 
list) remain intact during the expansion of (token list), and their effect is 
nullified. 


o \newlinechar=‘\(character). This command assigns to (character) the 
meaning of a line break within the arguments of the write commands. 
(The backslash is preceded by a left quote.) 


Example of Source Text \write15{Second line. OThird 
A file for the first Line.) \closeout15 


example in the previous 


dade Corresponding Formatted Text 
\newlinechar=‘\@ 

\openout15=yy.tex A file for the first example in the pre- 
\writei5{First line.} vious section. 


The command ‘\newwrite(control sequence)! can be used to automat- 
ically reserve a free output buffer and to record the index of the buffer in 
(control sequence). When we take it upon ourselves to allocate buffers, we 
should be aware that automatic reservations look for the free buffers with the 
smallest indexes. As a result, we are safer if we allocate buffers with high 
indexes. 
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The command \write16 can be used to write directly to the terminal. 
The command ‘\errmessage{(token list)}’ causes TEX to proclaim an error 
with the message (token list). 


Immediate Writing 


When a piece of text is processed, it is not known which page will include 
it because TeX determines the boundary of a page only after processing more 
text than the page can contain. Yet, the locations where different pieces of 
text reside must be determined for cross references, tables of contents, indexes, 
and so forth. To resolve this problem, the output commands are treated in a 
special manner. 

Specifically, the commands \openout, \closeout, and \write are not 
executed when they are encountered. Instead, they are executed when the 
boundaries of the pages that contain them are determined (that is, when the 
pages which contain them are ready to be shipped out to the dvi files). The 
same is true for the expansions of the arguments of the \write commands. 
The delays allow all the information about the pages to be determined before 
the \write commands produce their outputs. 

Sometimes these delays are undesirable because the arguments of the 
\write commands can lose their values during these periods. For instance, 
control sequences can change their meaning between the time the \write 
commands are encountered and the time the pages are shipped out. The 
command \immediate can be inserted as a prefix to the \write, \openout, 
and \closeout commands when no delay in execution is desired. 


Example of Source Text \write15{\x0Third Line.} 
\newlinechar=‘\@ \immediate\closeout15 
\input yyy 


\immediate\openout15=yyy.tex 
\def\x{First line.} 
\immediate \write15{\x} 


\def\x{Second line.} 
\immediate First line. Second line. Third Line. 


Corresponding Formatted Text 


Expandable and Nonexpandable Tokens 


The \write command keeps intact the nonexpandable tokens in its token 
list and treats them like parameterless commands that do nothing. 

The nonspecial characters are trivial examples of nonexpandable tokens, 
whereas macro names are trivial examples of expandable tokens. The distinc- 
tion between tokens that are expandable and tokens that are not expandable is 
less clear among the primitive control sequences of TEX. Yet, there are only a 
few expandable primitive control sequences, and they are identified in the fol- 
lowing list: conditional commands, \botmark, \csname, \endcsname, \endin- 
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put, \expandafter, \firstmark, \fontname, \input, \jobname, \meaning, 
\noexpand, \splitfirstmark, \string, \the, and \topmark. 


Example of Source Text \message\sv 
\immediate\write15{+*#*} 
\immediate\closeoutiS 
\input OutFile.xx } 

\out \out 


\def \message#1{\ immediate 
\write1l15{message: 
\ifcase#1 new file 
\else rewrite file \fi}} 
\def\out{\openini5=0utFile.xx 


Aifeotio Aaa vey LOT VETRO Corresponding Formatted Text 


\def\sv{1}\fi 
\closein15 \immediate message: new file 
\openout15=0utFile.xx . *** message: rewrite file *** 


Contents of variables that are being exposed with the \the command are 
treated as nonexpandable within the arguments of the \write commands. 


Example of Source Text \immediate\write15{*«**} 
\def \DEF#1{\tok={#1}% \DEF \define#i { eee .J 
\ifx #1\undefined \else \immediate\closeout15 
\immediate\write15{ \def\define{{\tt 
warning -- redefines \char92 define}} 
\the\tok }\fi \input nm.xx 
\def#1} 
Meee “ie Corresponding Formatted Text 
edia enout15=nm. xx 
\DEF\define{. .} *** warning — redefines \define 


Whatsits 


The \openout, \write, and \closeout commands that are not preceded 
by the \immediate prefix introduce into the text entities similar to empty 
boxes of zero height, depth, and width. These invisible entities, called what- 
sits, should be considered for possible side effects. In particular, it should 
be noticed that \nobreak commands before whatsit entities do not prohibit 
breakpoints after these entities. 

The \special, \language, and \setlanguage commands also insert 
whatsit entities into the text. The \special command is a parametric com- 
mand of the form ‘\special{(tezt)}’, and it introduces its parameter with 
no processing into the dvi file. It is typically used for importing into docu- 
ments figures that are produced elsewhere. The other two commands are not 
discussed here. 
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Exercises 


14.1.1 Write the necessary macros in an auxiliary file so that the source text 
will imply the formatted text. 


Source Text Formatted Text 
\input style.prg HAHA BaBa 
\Title{HaHa} BaBa HeHe BeBe 
\SubTitle{HeHe} BeBe HuHu BuBu 
\SubTitle{HuHu} BuBu HIHI BiBi 
\Title{HiHi} BiBi HoHo BoBo 


\SubTitle{HoHo} BoBo 
14.2.1 Prepare a file that holds one integer value per line. Then, for each of 
the following cases, write a source text that produces the desired text. 
a. The last value in the file. 
b. The smallest value in the file. 


14.3.1 Write a two-parameter macro \CopyFile that creates a new file whose 
name is given by the first parameter. The new file should have the same 
content as the file whose name is given in the second parameter. Assume that 
the source file contains no special TẸX characters. 


14.3.2 Identify the problem with the following source text and fix it. 


\openoutiS=a.tex \write15{aaa} \closeouti5 
\input a.tex 


Chapter 15 


DEEPER INTO 
MACROS 


TEX offers very powerful macro mechanisms. Chapter 11 started to look at 
some of these mechanisms, and this chapter is in essence a continuation of 
Chap. 11. The first section of this chapter shows how definitions of macros 
and of other tokens can be duplicated, the second considers macros that are 
expanded according to the conditions that exist during the time that they are 
defined, and the third introduces features for locally controlling the expansion 
of tokens. The fourth section concludes the chapter by studying tailored 
delimiters for parameters of macros. 


15.1 Duplicated Definitions 


The \def command defines a macro directly by explicitly providing its name 
and replacement text. Indirect definitions are also possible in TpX, and they 
can take the following form. 


Met (target control sequence)=(source token) 


The \let command defines a new macro whose name is (target control 
sequence) and whose body is equal to the one that (source token) has at the 
time the command is encountered. In the command, (target control sequence) 
and (source token) are assumed to be control sequences, with the latter being 
the name of an existing macro. 


Example of Source Text Corresponding Formatted Text 
\def\a#1{#1#1#1} \let\b=\a ees 
\def\a{cc} \a\b{.} 
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The \let command assigns to one control sequence the meaning of an- 
other control sequence, where the meaning of a macro name is its replacement 
text. 


Example of Source Text \let\third=\save} 
\def\first{one} \next, \next, \next, 
\def \second{two} \next, \next. 

\def \third{three} 

\def\next{\first 


\let\save=\first 
\let\first=\second 
\let\second=\third one, two, three, one, two. 


Corresponding Formatted Text 


The ability to transfer definitions among control sequences opens the door 
to many applications. For instance, it allows us to save the definition of an 
existing control sequence in order to redefine the control sequence to acquire 
an extended meaning. 


Example of Source Text must appear within math 


\let\xldots=\ldots mode\1dots 

\def\ldots{\ifmmode\xldots 
1 1d fi I 

Meira. I VEIdote VEU) Corresponding Formatted Text 

In its default form, In its default form, \ldots must ap- 

{\tt\string\ldots} pear within math mode... 


Definitions made with Met are local to the groups that contain them. 
The definitions can be made global with the \global command. 


Primitive Tokens 


The command ‘\let(target control sequence)=(source token)’ in its most 
general form allows any token for (source token)—not just a macro name. The 
command does not care whether a token is a character or a control sequence, 
or whether a control sequence is primitive or not. The command just assigns 
to (target control sequence) the current meaning of (source token). 


Example of Source Text Corresponding Formatted Text 


\let\x=\def \x\yfaa} Ny aa b 
\let\x=b \x 
The meaning of a token is the definition that is given to the token, not 
the outcome of the expansion of the token. 


Example. The definition ‘\def\endif{\fi}’ provides to \endif a 
meaning that differs from the one that \fi carries. On the other hand, 
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the definition ‘\let\endif=\fi’ assigns to \endif the same meaning 
as \fi. ; i 


The (source token) in the \let command can also be the name of an 
undefined control sequence. In such a case, (target control sequence) loses 
any meaning that it has. Normally, such variants of the \let command are 
employed to reclaim memory from definitions that are not needed any more. 


Example of Source Text \advance\x by\d 
\newcount\c \newcount\d \the\x 

\c=1 Md-5 

\ifnum \c>\d \let\x=\c ; 

\else \let\x=\d \fi Corresponding Formatted Text 
\advance\x by\c 12 


4 


What TpX Sees in Tokens 


In most cases, TpX does not care what tokens look like. Instead, it 
just cares about their meanings. For instance, when TX tries to match the 
Mif (condition)'s, \else’s, and \fi’s of selectors, it does not look for control 
sequences that carry such names. Instead, it looks for control sequences that 
carry the same meaning as the \if(condition)’s, \else’s, and \fi’s. 

Similarly, when TEX processes braces that serve as delimiters fora group, 
it does not care if the delimiters appear explicitly in the form of brace charac- 
ters, or implicitly in the form of control sequences that carry the meaning of 
braces. In fact, TEX even offers the pair of definitions ‘\let\bgroup={’ and 
‘\let\egroup=}’, just to allow for indirect references to braces that delimit 
groups. : 


Example of Source Text ; Corresponding Formatted Text 
gg{\it gg\egroup gg ; 889988 


Such indirect references provide to braces the benefits they did not share 
with the delimiters \begingroup and \endgroup. That is, now braces can be 
(indirectly) embedded within token lists without having to be balanced there. 


Example of Source Text Corresponding Formatted Text 
\def\Hbox{\hbox\bgroup} ` One two 
\def\EndHbox{\egroup} three 

\leavevmode i four 


\Hbox One \EndHbox 
\Hbox two \EndHbox \par' 
\Hbox three \EndHbox i 
\Hbox four \EndHbox 
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The indirect references to braces, however, cannot replace braces that 
delimit bodies in definitions of macros, actual parameters in calls to macros, 
or values that are assigned to variables. 


Future Let 


When TpX encounters a stream of tokens of the form 
Met (token; )z (tokenz) (tokens). . . 
it assigns to the first token (token) the meaning of the second (token;), then 


processes the text ‘(tokeng)...’. 
On the other hand, TEX also offers a variant \futurelet of the \let 


command that on a stream of tokens of the form 
\futurelet(token,) (token2) (tokena). . . 
assigns to the first token (token) the meaning of the third token (tokens), 


then processes the text ‘(tokenz)(tokeng) ...’. 


Example of Source Text Corresponding Formatted Text 
\def\y{\itx [Nx Math mode [a+ b], and 
\let\next=$ \else 
\def\next{$$}\fi \next} (a+b) 
Math mode 
\futurelet\x\y[atb]\y, and displayed math mode. 
\futurelet\x\y(atb)\y 


displayed math mode. 


15.2 Expanded Definitions 


The \def command associates nonprocessed replacement texts with control 
sequences. The replacement texts are expanded when the macros are invoked, 
according to the conditions that exist when the invocations occur. TX offers 
an alternative command, named \edef, for defining macros. The command 
\edef is similar to \def in its form; that is, it takes the following form. 


\edef (macro name) (formal parameters) {(replacement text)} 


However, now TEX does not associate the nonprocessed token list (replace- 
ment tezt) with the control sequence (macro name). Instead, TEX expands 
the token list (replacement tezt) according to the conditions that exist at the 
time of the definition, then it associates the expanded form of (replacement 
text) with the control sequence (macro name). 


Example of Source Text Corresponding Formatted Text 


\def\a{aaaaaaaa} \edef\b{\a} aaaaaaaa 
\def\a{cccccccc} Nb 
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Ordinary definitions assign the given token lists (replacement tezt) as 
replacement texts for the macro names, whereas expanded definitions assign 
the expansions of the given token lists (replacement tezt) as replacement texts 
for the macro names. 


Example of Source Text Corresponding Formatted Text 


\def\a{xx} \edef\a{\a} \a xx 
% infinite loop 
% for ‘\def\a{\a} Na? 


The different natures of the ordinary and expanded definitions quite often 
imply different outcomes for identical token lists (replacement tezt). 


Example of Source Text 4 Corresponding Formatted Text 
\def \xs{x} XX, XXXX, and xxxxxxxx. 
\def\morexs{¥, 

\edef\xs{\xs\xs}\xs} 


\morexs, \morexs, and \morexs. 


Macros that are defined with \edef are local to the groups that contain 
them. The definitions can be made global by inserting the control sequence 
\global before the definitions. The control sequence \xdef is provided as a 
shorthand way of writing ‘\global\edef’. 


Example of Source Text i values in Vin, then we get the 
\def\int} \def\out{} values in \out, respectively. 
\newcount\c 


\def\*{\advance Nc by 1 


\edef\in{\in\ \the\c} Corresponding Formatted Text 


{\multiply \c by \c If we square the values in 1 2 3 4, 
\xdef\out{\out\ \the\c}}} then we get the values in 149 16, 
\*\*\*#\* If we square the respectively. 


Expandable and Nonexpandable Tokens 


The \edef command expands its given token list (replacement tezt) un- 
der the same conditions as the \write command expands its argument (see 
Sec. 14.3). 


Example of Source Text Corresponding Formatted Text 


\newtoks\a \a={aa} aa..aa aa..xx 
\newtoks\b \b={\the\a} 
\edef\c{\the\a..\the\b} 

% \def\cfaa. .\the\a} 
\c \a={xx} \c 
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That is, the \edef command processes the expandable tokens and does 


not process the nonexpandable tokens. 


Example of Source Text 


\def \x#1{\def\temp{#1}¥% 


\ifx \temp\empty 
\y \let\x=\relax 


\else \edef\y{#1\y}\fi Nx 


\def\y{} \x123456{} 


Corresponding Formatted Text 
654321 


Similarly, the \edef command also does not process the formal parame- 


ters. 


Example of Source Text 


\def\x{d} \edef\x#1{#1\x} 
\x{ac}, \x{ax}. \tt\meaning\x 


Corresponding Formatted Text 
Acd, axd. macro:#1->#1d 


In addition, the \edef command does not expand the tokens that the 


\the command exposes. 


Example of Source Text 


\newcount\c \newcount\d 
\newtoks\t \c=10 \d=11 


\t={\the\c, \the\d. } 
\edef \exchange{\the\t 
\c=\the\d 


\d=\the\c \the\t} 
\exchange 


Corresponding Formatted Text 
10, 11. , 1011. 


Expandable tokens can be protected within \edef commands by intro- 
ducing the tokens indirectly through token variables that are exposed with 
the \the command. Temporary changes in the meaning of tokens and the 
\noexpand command, which is introduced in the next section, can also be 
employed to protect expandable tokens within \edef commands. 


Example of Source Text 


\let\svor=\or 
\let\svfi=\fi 
\let\svif=\ifcase 
\let\or =\relax 
\let\noor =\relax 
\let\ifcase=\relax 


\let\fi =\relax 
\let\oldor =\relax 
\def \OR{\noor\or} 


\edef\Table#1{\ifcase#1 
10,N0R 11,\OR 12,N0R 


13,N0R 14.\fi \oldor} 
\def\oldor{\let\or=\svor } 
\def \noor{\let\or=\relax} 
\let\fi=\svfi 
\let\ifcase=\svif 
\oldor \Table4 \Table3 
\Table2 NTablei \Table0 


Corresponding Formatted Text 


14. 13,14. 12,13,14. 11,12,13,14. 
10,11,12,13,14. 
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15.3 Changing the Rules 


TEX provides some commands that can be applied to modify the way macros 
are defined and used. The following are four important commands of this 


kind. 


Prevented Expansions 


The command ‘\noexpand(token)’ produces the token (token) and tem- 
porarily makes the token nonexpandable (with the same meaning as \relax). 


Example of Source Text Corresponding Formatted Text 
% \def\x{aa\b} aacc 

\def\af{aa} \def\b{bb} 

\edef\x{\a\noexpand\b} 


\def\b{cc} x 


Delayed Expansions 


The command \expandafter interferes with the order in which the pair 
of tokens that follow it are processed. In a piece of text of the form ‘\ex- 
pandafter(token;) (token;)', the command delays the processing of the first 
token until after the second one is processed according to its meaning. 


Example of Source Text Corresponding Formatted Text 


\def \a{\def \b{aa}} bbaa 
\def\b{bb} \expandafter\a\b\b 


If the second token requires no action, then \expandafter has no effect. 
If the second token is a primitive token, then \expandafter lets the second 
token be fully processed according to its meaning. 


Example of Source Text , Corresponding Formatted Text 


\def\x{\let\y=} -\jobname- -f- f 
\expandafter\x\jobname 
\ifx \y\jobname ** \else \y\fi 


If the second token is a primitive token that needs to consume and process 
some text, then \expandafter will let it do so. 


Example of Source Text \choice0, \choice1, 
\def\choice#i{y, \choice2. 
\expandafter\e 


\ifcase#i {10}\or 
{20}\or {30}\fi} j 
\def \e#i{$e~{#1}$} el9, e20, e30, 


Corresponding Formatted Text 
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On the other hand, if the second token is the name of a parameterless 
macro, then the \expandafter command will provide only a delay that will 
allow for the substitution for the macro name of its replacement text. 


Example of Source Text Corresponding Formatted Text 
\def\x{\y} \def\y{a} b 
\def\u{\def\y{b}} 


\expandafter \u \x 


Similarly, if the second token is the name of a parametric macro, then 
the \expandafter command will provide a delay that will allow for the con- 
sumption of the actual parameters, for the substitution for the macro name 
of its replacement text, and for the substitution for the actual parameters of 
the formal parameters. 


Example of Source Text Corresponding Formatted Text 


\def \a#i#2{x} \def\b#1{#1#1} xxf 
\expandafter \b \a cdf 


The \expandafter command works on tokens that are control sequences 
and on tokens that are characters. The net effect of the command is to 
temporarily hide the first token from TpX. 


Example of Source Text Corresponding Formatted Text 


\newcount\c \c=1 \newtoks\t 12 
\t=\expandafter{\the\c 
\the\c} \c=2 \the\t 


The \expandafter command can also reverse the order of processing of 
more than two tokens. In particular, in a piece of source text of the form 
‘\expandafter \expandafter \expandafter (token; ) \expandafter (tokenz) 
(tokeng)’, the tokens (tokens), (tokeng), and (token) are expanded in the 
given order. Such constructs enable incremental definitions of macros. 


Example of Source Text Corresponding Formatted Text 


\def\x{\y} \def\temp{\def\x} macro:->\y Mz 
\expandafter\expandafter 

\expandafter\temp 

\expandafter{\x\z} 
\tt\meaning\x 


Indirect Control Sequences 


The command ‘\csname(token list)\endcsname’ expects to find between 
\csname and \endcsname a sequence of characters. The command produces 
a control sequence that starts with an escape character and continues with 
the given sequence of characters. 


15.3 CHANGING THE RULES 


Example of Source Text 


\def \abc{xxx} 
\csname abc\endcsname 
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Corresponding Formatted Text 
XXX 


The tokens between \csname and \endcsname may directly or indirectly 


tefer to characters. 
Example of Source Text 


\def\abc{xxx} \def\y{b} 


Corresponding Formatted Text 
xxx 


\esname a\y c\endcsname | 


If the command ‘\csname(token list)\endcsname’ produces a new con- 
trol sequence that has no meaning yet, it also gives the control sequence a 
definition with the same meaning as \relax. 


Example of Source Text Corresponding Formatted Text 


% \xyz undefined al 
\csname xyz\endcsname a; 

% \xyz equivalent to \relax 

\ifx \xyz\relax i\else 2\fi 


Indirect control sequences can also be made from characters that are not 
letters. Such control sequences can be referenced only indirectly, and so they 
offer extended protection from unintentional references. 


Corresponding Formatted Text 
bb, aa. 


Example of Source Text 


\def \x{bb} 
\expandafter 
\def\csname x \endcsname{aa} 
\csname x\endcsname, 
\csname x \endcsname. 
Indirect definitions of control sequences enable the definition of dynamic 
hierarchies of control sequences. 


\newcount\c \push{10.} 
\push{20, } \push{30, } 
\pop \pop \pop 


Example of Source Text 


\def\push#1{\expandafter 
\edef \csname 
\the\c\endcsname{#1}¥ 
\advance\c by 1 } 
\def\pop{\advance\c by-1 
\csname\the\c\endcsname } 


Corresponding Formatted Text 
30, 20, 10. 


Strings from Tokens 


The \csname command produces control sequences from sequences of 
characters. The \string command goes the other way. It converts tokens 
into sequences of characters. 
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Example of Source Text Corresponding Formatted Text 
\string\begingroup X “begingroupX \begingroupY $ 
\tt \string\begingroup Y 

\string$ 


The \string command enables the listing of control sequences and the 
creation of interrelated control sequences. 


Example of Source Text \DEF \xx#1{**#1 e] 
\def \DEF#14Y \abc, \xx{xy}, \xx{\abc}. 
\def#i{{\tt\string#1:} 
\expandafter\csname 


\string #1\endcsname}% 
\expandafter\def\csname 

\string #1\endcsname} Nabc: ABC, \xx: **xy**, 
\DEF\abc {ABC} \xx: **\abc: ABC**, 


Corresponding Formatted Text 


15.4 Delimiters for Parameters 


The definitions for macros that we have considered so far implicitly require 
that the actual parameters be delimited by braces. Yet, the definitions can 
also require other delimiters for the actual parameters. 

Specifically, a sequence (delimiter) of tokens can be declared to be the 
delimiter for the ith actual parameter of a macro by inserting the sequence 
in the definition of the macro after the ith formal parameter ‘#i’ in the list 
(formal parameters). In such a case, an invocation of the macro assumes that 
the ith actual parameter is the shortest text that satisfies the two conditions 
below. 


a. The text is delimited at its end by (delimiter). 


b. The text starts at the point where the delimiter for the preceding actual 
parameter ends. 


Example of Source Text Corresponding Formatted Text 
\def\cost#1$#2.#3${#1 costs Bread costs 2 dollars and 52 cents. 

#2 dollars and #3 cents.} Milk costs two dollars and twenty 
\cost Bread$2.52$ cents. Car costs 9,999 dollars and 
\cost Milk$two.twenty$ 99 cents. 


\cost Car$9,999.99$ 


Delimiters increase the readability of source text. For completeness, TEX 
allows also a “delimiter” for the names of the macros. 
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Example of Source Text Corresponding Formatted Text 
\def\sqr (#1 ,#2) {column A queen of chess can move from col- 

#2 in row #1} umn 4 in row 4 to column 6 in row 
A queen of chess can move 6, but not to column 7 in row 6. 


from \sqr(4,4) to \sqr(6,6), 
but not to \sqr(6,7). 


Braces within actual parameters must be balanced. Therefore, TEX does 
not search for delimiters that are embedded within braces. 


Example of Source Text Corresponding Formatted Text 

\def\see#idel#2#3..{The first The first actual parameter is ‘abc’ 
actual parameter is ‘#1? and the second is ‘85’. The third 
and the second is ‘#2’. contributes ‘A..Z. ' 


The third contributes ‘#3’} 
\see abcdel{85}% 
\uppercasefa..z}. .. 


The delimiters are allowed to contain any token except braces and the 
character ‘#’. However, two or more consecutive space characters are treated 
as a single character. (Recall also that space characters are ignored between 
actual parameters that use default delimiters.) 


Example of Source Text Corresponding Formatted Text 


\def\x#1  #2#3#4\\{ -11-22-33- 44-55 
-#1-#2-#3-#4-} 
\x11 {22} {33} 44\\55 - 


Exercises 


15.1.1 Replace a \def command with a \let command in the following 
source text without affecting the outcome. 


\newcount\c 
\def\symbol{\advance \c by 1 
\ifnum \c=128 \def\symbol{\relax} 
\else\ \char\c \fi — Nsymbol) X81 \symbol 


15.1.2 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text Formatted Text 
\parity, \parity, \parity, odd, even, odd, even. 
\parity. 
b. Source Text Formatted Text 
Roman \bf{bold} roman  - Roman bold roman italic roman. 


\it{italic} roman. 
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C. 


Source Text 


$\over{1}{2}+\over{1}{3}= 
Nover56$ 


DEEPER INTO MACROS 


Formatted Text 


141—585 
7+3-6 


15.1.3 Redefine \hskip so that in horizontal mode it will remove a horizontal 
space of width \lastskip before inserting a new space. 

15.2.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. 


15.2.2 Explain the following source text. 


a. 


Source Text 


\ys, \ys, \ys. 


. Source Text 


\add{aa} \add{bb} \add{cc} 
\add{dd} \see 


. Source Text 


\def\first{One} \next{two}, 
\next{three}, \next{four}. 


\def \save#i{Y, 
\edef \recall{#1=\the#1 }} 


Formatted Text 
Y YY, YYY. 
Formatted Text 
ddccbbaa 


Formatted Text 


One two, two three, three four. 


\newcount\c \c=1 \save\c \c=2 \the\c \recall \the\c 


15.3.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


Source Text 


\def\z#i{\ifx #1, 
\expandafter\x \else 
\expandafter\y \fi} 

\z, {True} \z.{False} 


. Source Text 


\lessx, \lessx, 
\lessx, \lessx. 


. Source Text 


\def\gobble#i{} \def\xx{aaa} 
\def\x{bbb} \def\yy{ccc} 
\def\y{ddd} 

\TwoCommands {xx} 
\TwoCommands {yy} 


. Source Text 


\see\x \see\y 


Formatted Text 
True, False. 


Formatted Text 


XXXXXX, XXXXX, XXXX, XXX. 


Formatted Text 
aaabbb cccddd 


Formatted Text 
\def\x{xx}\def\y{yy} 
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15.4.1 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text Formatted Text 
Sometimes we want to hide Sometimes we want to hide source - 
source text\ignore like text. 


here \endignore. 
b. Source Text Formatted Text 


$\(a,b)+\(c,d)=\(adtbc ,bd)$ 2 4 S — adibe 


Chapter 16 


CHARACTERS 


We started to study TeX by looking at its characters. We classified the char- 
acters into special characters and nonspecial characters, and at the beginning 
we distanced ourselves from the special characters. As we went on studying 
TX, we learned the special characters and began to use them. Yet, it may 
seem surprising, but so far we have hardly scratched the surface with respect 
to how TeX looks at its own characters. 

This chapter consists of three sections. The first section identifies the 
characters of TFX, the second considers how TpX interprets the meaning of 
the characters, and the third shows how we can change the algorithm that 
assigns meanings to the characters. 


16.1 Character Codes 


When we type a source document, we use the characters in our keyboards. 
When TpX processes a document, it uses a set of characters of its own. 
And when an output device produces a formatted document, it uses symbols 
(=characters) that are designed for the device. So how does TpX bridge the 
gap between these different sets of characters? The answer is quite simple—it 
uses a table-oriented encoding scheme. 

. Specifically, as we saw in Chap. 4, TEX assumes that the output symbols 
are organized into fonts. Moreover, TEX assumes that each font is made up 
of 256 symbols, and that each font is organized into an output table. On the 
other hand, TẸX assumes that keyboards use just the following 95 characters. 
These are the characters that appear on a "standard" English keyboard, that 
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D 
) 
< 


^ ^ 


“le 


DE 


Tr 
m 
F 
H 
rh 
- 


y 
Figure 16.1 Characters of TgX. 


is, an ASCII keyboard. 


abcdefghijklmnopqrstuvxyz 
ABCDEFGHIJKLMNOPQRSTUVXYZ 
0123456789+-*/|\[]{}()<>= 
12.,:; OHSA u 


For its own set of characters, TEX chooses an extension of the set of ASCII 
characters. The extension consists of 256 characters, to match the number of 
symbols in the fonts. Each TEX character is either an ASCII character or a 
combination of ASCII characters. Figure 16.1 gives an encoding table which 
lists rowwise the first 128 characters of TeX. The ith character in this list is 
said to have character code i. 

From the point of view of TEX, each entry in the encoding table represents 
one internal character. When TpX scans a source document, it maps the 
sequence of input characters into a sequence of internal characters. When Tex 
encounters an internal character that goes into the formatted document, it 
maps the character into an output symbol. The mapping is done in accordance 
with the correspondence that exists between the encoding table and the output 
table. 


Example. When we type an ‘A’ on our keyboard, we refer to entry 65 
in the encoding table. Hence, in the formatted document, we get the 
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corresponding symbol from the output table of the active font. If the 
output table is the one that is given in Fig. 4.1 for the roman font, 
then we get the symbol ‘A’ from entry 65 in that table. 


Similarly, when we type '^^H', we refer to entry 8, and we get the 
output symbol ‘&’ in the output table. On the other hand, if we type 
*773J/S2^^ ., we get 'Q/S-Q'. 


The correspondence between the encoding table and the output tables 
explains why in some fonts the input characters ‘>’, ‘<’, and ‘|’ provide the 
“strange” output symbols ‘j’, ‘p’, and ‘—’, respectively. 

The encoding scheme does not provide for direct access to the output 
symbols that correspond to special characters. For these symbols, we need to 
use the \char command with the appropriate character codes. 


Some Interesting Control Characters 


On a standard English keyboard, TEX gets the encoding ‘““M’ when we 
press the end-of-line (or return) key. Similarly, the tab key produces the 
encoding '^^I'. In addition, ‘^^K’ and *^^A' are encodings for the keys ‘t’ and 
*4' that appear on some extended keyboards, and '^^L' stands for the feed 
form character. 


Example of Source Text Corresponding Formatted Text 
First input line.^^M... First input line. Second input 
Second input line.^^M... line. 

^M... The ...'s are ignored because an 
The ...?s are ignored end-of-line character sends TẸX into 
because an end-of-line a new input line. 


character sends \TeX\ 
into a new input line. 


16.2 Category Codes 


We have already seen that TpX treats different characters in different manners. 
It views some characters as special and some as nonspecial. It refers to some 
characters as letters, and to some other characters as nonletters. It uses the 
backslash character ‘\’ for identifying control sequences, and it ignores some 
space characters. And so forth. 

TX achieves such functionality by assigning to each character a number 
between 0 and 15 and assuming that the meaning of each character is deter- 
mined by the number assigned to it. The numbers are called category codes, 
and Fig. 16.2 shows how they are assigned to the characters. 


Example. TgX treats the character ‘\’ as an escape character only 
because ‘\’ has category code 0. Similarly, TEX treats the character "v 
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Characters ! Categories 


N 0 — escape character 

{ 1 — begin-group character 
} 2 — end-group character 
$ 3 — math character 

& 4 — alignment character 


^M 5 — end-of-line character 
# 6 — parameter character 
aK 7 — superscript character 
rs | 8 — subscript character 
^^Q 9 — ignored character 
u,^^I 10 — space character 
85.42; l2 11 — letter character 
not listed above or below 12 — other character 
T$ cL 13 — active character 
4 14 — comment character 
^7? . 15 — invalid character 


Figure 16.2 Category codes for characters. 


as a comment character just because it has category code 14. If ‘% had 
happened to have category code 12, it would have been treated like ‘+, 
‘Œ, ‘I’, and other characters of category code 12. On the other hand, 
if ‘*’ had happened to carry category code 14, then it would have been 
treated as a comment character. 


In Sec. 2.1 we listed some TEX characters that are considered to be spe- 
cial. The full list of special characters consists of those characters that have 
category codes other than 11 and 12. 

The category code of a character (char) can be retrieved with the com- 
mand ‘\the\catcode(character code)’. 


How Macros Are Scanned 


TEX reads its inputs character by character. As it reads the characters, 
it assigns category codes to them and assembles them into tokens. Whenever 
TEX finds a token, it pauses. During each pause, TEX processes the token in 
hand according to its meaning. 

When TEX encounters the token \def or the token \edef, it scans the 
succeeding token and verifies that the new token is a control sequence. The 
new token should be the name chosen for the new macro, and therefore it 
requires no further processing. 

After finding the name, TEX continues scanning the input characters. 
As it reads the characters, it assembles them into tokens and searches for a 
character token that has the category code 1. In the default setting, this search 
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amounts to a search for the token ‘{’. The tokens that are being assembled 
in this phase are treated like nonexpandable tokens. They define the formal 
parameters and the delimiters for the parameters. 

After finding a character token with category code 1, "TEX resumes scan- 
ning the input characters. As it reads the characters, it assembles them into 
tokens, but it does not process the tokens. This phase continues until TEX 
finds a character token that carries the category code 2 and that provides for 
a body that is balanced with respect to character tokens of category codes 1 
and 2. In the default setting, the character ‘}’ carries category code 2. 


Example of Source Text Corresponding Formatted Text 
\def\}{aa} \def\x{\}} \x aa 


When TpX looks for an actual parameter with default delimiters, it scans 
the input for the next token. If the token is a character of category code 1, it 
is treated as a left delimiter and the actual parameter is scanned in a manner 
similar to the one used for scanning the bodies of macros. Otherwise, the 
token is considered to be the actual parameter of the macro. 

When TFX looks for an actual parameter with nondefault delimiters, 
it requires that the corresponding character tokens in the delimiters for the 
formal parameter and for the actual parameter agree in both their character 
codes and their category codes. 


Category Codes in Selectors 


The \if command considers two characters to be equal if they have the 
same character codes. It ignores the category codes of the characters. 

The \ifx command treats two characters as equal if both their character 
codes and their category codes agree. 

The \ifcat command is a variant of the \if command that tests non- 
expandable tokens for the equality of their category codes. Nonexpandable 
control sequences that do not derive their meaning from characters (with the 
Met command) are treated as tokens with imaginary category code 16. 


16.3 Indirect Access 


The two constructs ‘ ‘(character)’ and * ‘\(character)’ produce the character 
codes of the listed characters in locations where TEX expects to find integer 
values. The quote characters in the constructs are left quotes. 


Example of Source Text Corresponding Formatted Text 


\newcount\c \char‘\%: \c=‘\% %: 37, A: 65. 
\the\c, \char‘A: \c=‘A \the\c. 


16.4 CHANGES IN CATEGORY CODES 125 


16.4 Changes in Category Codes 


Normally, we do not have to bother with the category codes of the characters. 
All we need to know is the characters! meaning (as assigned to them by their 
category codes). And in fact, this has been the case so far. 

However, sometimes we may want to change the way category codes are 
assigned to characters, to alter the meaning that TpX associates with the 
characters. Changes in the way in which category codes are assigned are 
useful for sophisticated applications, but they should be made with care to 
avoid undesirable side effects. It is very easy to change the algorithm that 
determines the assignment of category codes, but it is even easier to get lost 
with such changes. 

To assign a new category code (category code) to characters that are 
scanned from the input in the future, all we need to do is to insert the com- 
mand ‘\catcode(character code)=(category code)’ for the character codes of 
the characters. A character that is assigned a new category code is treated 
according to the rules that govern the characters in that category. 


Example. The command ‘\catcode‘\@=11’ asks that the character 
‘@’ be assigned the category code 11. From that point on, any ‘Q’ 
characters that TEX scans are considered to be letters and are treated 
like any of the other letters ‘a’,..., ‘z’, ‘A’,..., ‘Z’. For instance, under 
the new conditions, TEX scans \a@b as a single token which is a control 
word, whereas when ‘@’ has the default category code of 12, we get the 
three tokens ‘\a’, ‘0’, and ‘b’. 

Similarly, ‘\catcode‘\[=1’ asks that future appearances of the char- 
acter '[' be assigned the category code 1. From that point on, the 
characters ‘[’ and '(" are treated as indistinguishable delimiter charac- 


ters which can be interchanged. Consequently, we can type ‘{...}’ or 
* E... without TEX seeing the difference. 


The different category codes that can be associated with the characters 
in effect increase the number of characters that are available to TeX by a 
factor of 16. For instance, when TEX encounters the character ‘a’ in an input 
file, internally it assumes that it read one of the characters ‘ao’, ‘ar’,...,‘ars’, 
dependent on the category code that is in effect for ‘a’. 


Example of Source Text Corresponding Formatted Text 


^ \def\x{ajib} \def\x{ai1b} ab. c. 
\def\x{ab} \catcode‘\a=0 
\def\y{ab} \def\b{c} Nx. Vy. 


Scope 


Changes within a group to the algorithm that assigns category codes 
persist only until the end of the group. 
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Example of Source Text Corresponding Formatted Text 


\begingroup * comment *%* 
\catcode‘ \*=14 
\catcode'\%=12 %* comment 
\endgroup */% comment 


When TFX reads a character from the source document, it immediately 
determines the category code of the character according to the conditions that 
exist when the character is read. From that instant on, the category code of 
the character cannot be changed. This observation is very important, and it 
should be kept in mind when designing applications that rely on changes in 
category codes. 


Changes within Macros 


Each character of a source document is assigned a category code which 
determines the way the character should be treated. The category codes are 
assigned according to a mapping function that TEX provides (see Fig. 16.2) 
and that the user can dynamically modify. Modifications of the mapping 
function can have powerful results, but they are also dangerous. Problems 
may quite easily arise because the characters do not exhibit their meaning. 
That is, their meaning has to be carried in the user’s mind—a task that gets 
quite complex in a changing environment. Moreover, the complexity increases 
when macros are present, because macros are features that move characters 
around. 


Example of Source Text \c123 \the\c123, 
\def \newletter#1{ \oldcat \newcount\c 
\edef \oldcat{\catcode \c123 \the\c123. 
‘\noexpand#1= 


\the\catcode‘#1 } 
\catcode‘#1=11 } 
\newletter\1 \newcount\ci 2323, 123123. 


The category codes that the characters get are determined according to 
the conditions that exist when the characters are encountered for the first 
time. Hence, the characters in the body of a macro carry category codes that 
depend on the conditions that existed when the macro was encountered for 
the first time. 


Corresponding Formatted Text 


Example of Source Text Corresponding Formatted Text 


\catcode‘\!=7 4superscript TmT” 


\def\up{x !m} 
\catcode‘'\!=8 {subscript 
$x !m\up$ 
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Bodies of macros cannot change the category codes for their own charac- 
ters because no processing takes place when the macros are scanned. That is, 
the command \catcode does not have any effect within the body of a macro. 


Example of Source Text Corresponding Formatted Text 


\def\nomath{\catcode‘\$=12 f(z”), $t 1(x72)$. 
\catcode‘\*=12 
\catcode‘\_=12 $f 1(x^2)$) 
\tt \nomath, $f 1(x^2)$. 
Similarly, an appearance of \catcode within an actual parameter does 
not have any effect on the category codes of the characters in the parameter. 


Example of Source Text Corresponding Formatted Text 


\def\same#1{#1} \catcode‘\!=7 — z"z,, 
$\same{\catcode‘\!=8 x!m } 
x!m $ 
Some control sequences are considered to be parameterless commands 
that act on braced groups. In such cases, changes to category codes take 
effect immediately when the \catcode commands are scanned. 


Example of Source Text Corresponding Formatted Text 
\hbox{$ x^m \catcode‘\*=8 2” 2m 
x^m$) 


Control sequences that are names of macros whose definitions are pre- 
ceded by the prefix \outer are not allowed within replacement texts of macros, 
within actual parameters, within ignored portions of conditional commands, 
and within tables; ‘\+’ is an example of a command of this kind. Hence, the 
command ‘\catcode‘\+=...’ is illegal in such locations when ‘\+’ keeps its 
original meaning. 


Example of Source Text \gdef*{\global\multiply\c}%, 

\def\cats{\catcode‘+=13 \c=} 
\catcode‘-=13\catcode‘#=13  \endcats \def\.#1{‘{\tt#1}’} 
\catcode‘ ;=13} Within \.{\tt\string\expri+2* 


\def \endcats{\catcode‘+=12 14+1*2-73;} the characters 


\catcode‘-=12\catcode‘#=12 \-+» \.~, \.*, and \.; have 
\catcode‘ ;=12} category code \exprit+2*14+ 


\newcount\c \def\minus{-} 1*2-73;. 


\cats 
\def\expr{\bgroup \cats 
\gdef ;{\egroup\the\c }% 
\gdef+{\global\advance\c}% Within ‘\expri+2* 1441*2-73;' 
\gdef-{\global\advance\c the characters ‘+’, ‘-’, ‘*’, and ‘p’ 
\minus }% have category code 13. 


Corresponding Formatted Text 


128 CHARACTERS 


Active Characters 


Active characters (that is, characters with category code 13) are treated 
in the same manner as control sequences. 


Example of Source Text \def+{\hbox{ \bf or }} 
\catcode‘\-=13 $-x*y* (x*z)$ 
\def-{\hbox{ \bf not }} 
Ncatcode \*#=13 
\def*{\hbox{ \bf and }} 
\catcode‘\+=13 not z or y and (z or z) 


Corresponding Formatted Text 


Macros that are named with active characters cause minimal visual inter- 
ference in source texts. Moreover, since such names are in general meaningless, 
they are natural candidates for naming entities that dynamically change their 
meaning. 


Example of Source Text Corresponding Formatted Text 
\catcode‘\|=13 Roman and bold and roman and 
\def |{\begingroup \bf bold. 


Met |=\endgroup} 
Roman |and bold| 
and roman land bold]. 


In its default form, TpX sets the tie character '^' to be active, and it 
provides the definition ‘\def “{\nobreak\,,}’ for the character. The definition 
assigns to '^' the meaning of a nonignored space character that cannot be 
preceded by a break point. 


Example of Source Text for actual parameters 
\catcode'\%=13 Ndef'A Ces] VU. NC y. 
\catcode‘\%=14 


\def \x{\begingroup 
\catcode‘\%=13 \xx} , 
\def \xx#1{\endgroup Corresponding Formatted Text 
\def\y{#1}} Distinguished environment for 
Distinguished environment actual parameters ***. 


The Scanning Process 


TpX scans its inputs one character at a time, and it constructs tokens 
from the characters that it scans. When TpX finds a new token, it processes 
the token according to its meaning. Data elements, like integer constants and 
dimension constants, are constructed in a similar manner. However, for data 
elements, TFX may realize that it has found an element only after scanning 
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an extra character from the input. In such cases, the look-ahead characters 
are assigned their category codes before the processing of the data elements 
that they delimit. l 


Example of Source Text Corresponding Formatted Text 


{*\catcode‘ \x=9xxx*} *y* ** 
*\catcode‘\x=9 xxx* 


Characters of category code 9 are ignored by TEX, except for being rec- 
ognized as delimiters for tokens. In particular, such characters are not recog- 
nizable as delimiters for integer numbers and for dimensions. 


An Exception 


The commands \jobname, \meaning, \number, \romannumeral, \string, 
and \the assign the category code 12 to the nonspace character tokens that 
they produce. These commands are the only ones that can modify the cate- 
gory codes of characters. 


Example of Source Text Corresponding Formatted Text 
\newdimen\d \def\x#ipt{*##1#*} **11 Qpt...** 
\d=11pt i 


\expandafter\x\the\d. ..pt 


To space characters, the above commands assign category code 10. 


Example of Source Text \expandafter\y \expandafter 


\newcount\c \c=123 \string \x. 


\edef\x{\csname c \the\c: 
\endcsname} 

\def\y#1 {#1---} 

\tt \expandafter\string \x, 

\expandafter\expandafter Nc. 123, Nc---123. 


Corresponding Formatted Text 


Exercises 


16.1.1 Give a source text that generates the formatted text ‘Effi’ without 
using the \char command. 


16.1.2 Explain the behavior of TEX on the source text. 


MdefNxíaa^^Maa]) 
\x\bye 


16.2.1 Write a source text for the formatted text ‘a, and a,’ without using 
the space character ‘o’ and the subscript character ‘_’. 
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16.3.1 What is wrong with the source document ‘a \catcode‘ \\=12 b \bye’ 
and with the source document ‘a {\catcode‘\}=12 b} \bye’? 


16.3.2 For each of the following cases, change the category codes of the 
characters so that the source text will generate the formatted text. 

a. Source Text Formatted Text 

The characters ‘%’ and ‘#’ are spe- 
cial. 


Formatted Text 


The characters ‘%’ and 
*$? are special. 


b. Source Text 


\def\x{Have a nice day} 
\let\y@=\x VyO 


Have a nice day 


Formatted Text 
A-A,AZA 


c. Source Text 


\let\A=A  \catcode‘\A=11 
$\A Mf A\A=\else \neq\fi A, 
XA \ifx A\A=\else \neq\fi A$ 


d. Source Text Formatted Text 


|defla[NdefNaf...)] Itt la \def\a{...} 
16.3.3 Write a macro \KeepLinesOn that forces a line break in the formatted 
text whenever a line break appears in the source text. And write a macro 
\KeepLinesOff that delimits the scope of \KeepLinesOn. 
16.3.4 Find what meaning TpX assigns to the character ‘““L’. 
16.3.5 For each of the following cases, write the necessary macros so that 
the source text will expand to the formatted text. 


a. Source Text Formatted Text 


We can change the category codes 
of \, {, and }. Then we can write 


We can change the category 
codes of I\l, I{l, and |l. 


Then we can write \def\?{27}. 
|\def\?{?7}1. 

b. Source Text Formatted Text 
\def\0ff{\catcode‘\ =10 } 1 2 
\def\On{\catcode‘\ =13 } \tt 3 4 
1 2Nper \On 56 
3 4\par 78 

56 \par \Off 


78 


TAILORED 
SPHERES 


Chapter 17 


ENVIRONMENTS FOR 
WRITING 


When we write, our attention should be devoted to the content and orga- 
nization of what we want to say. Issues concerning the appearance of the 
document should not interfere with our thoughts. 

Macros can be employed to meet this end, by letting them associate 
visual appearance with logical structures. Then, during the writing phase 
we can use the macros just for their logical meanings, whereas during the 
production phase we can deal with their implementation. However, when 
we produce draft versions of our writing, we can restrict ourselves to coarse 
implementations of the macros. 

Macros for logical constructs allow not only for source documents that 
reflect their logical structures, but also for uniformity of style throughout the 
formatted documents. In addition, such macros allow us to define and modify 
the global appearance of a document locally. 

The objective of this chapter is to study some representative appearances 
of logical structures. The chapter consists of nine sections. The first eight 
consider the structures of divisions, blocks, lists, cross-references, tables of 
contents, figures, bibliographies, and indexes, respectively. The ninth section 
discusses the advantages of libraries of macros and offers a short introduction 
to the main features of LaTgX. Section B.3 looks at headers and footers, and 
Appendix D gives an environment for two-column text. 


17.1 Divisions 


Long documents are recursively divided into smaller logical units, to form 
hierarchies which outline and highlight the content and organization of the 
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documents. The units are provided with titles and level numbers. 
We define here a command named \Chapter for dividing documents into 
chapters, and a command named \Section for dividing chapters into sections. 


Example. The author used similar commands for writing this book. 
For instance, the author wrote the following source text for this chapter. 


\Chapter{Environments for Writing} When we write... 
\Section{Divisions} Long documents are... 
\Section{Blocks} Some logical units... 


Shared Features 


Normally, the leading paragraph in a chapter or a section starts without 
indentation, whereas the other paragraphs start with indentations. To achieve 
this effect, we can indicate an indentation for all the paragraphs, with a 
provision for removing it from selected paragraphs. 

In its default setting, TEX contributes an indentation of size \parindent 
to each paragraph. The following code gives us the means for removing the in- 
dentations from selected paragraphs just by setting the switch removeindent 
to a true value. 


\newif \ifremoveindent 
\everypar{\ifremoveindent \hskip -\parindent 
\removeindentfalse \fi} 


An automatic numbering scheme for chapters and sections (and other 
items) saves the users the meticulous work of setting the numbers manually 
or, even worse, changing the numbers whenever chapters and sections are 
deleted, added, or moved around. 

We introduce the following counters for recording numbers of chapters 
and sections. The declarations initialize the counters to 0. 


\newcount \ChapterCounter 
\newcount \SectionCounter 


Chapters 


The \Chapter command starts a new chapter. The title of the chapter 
is given in the actual parameter. 


\def\Chapter#i{\supereject 
\global\advance\ChapterCounter by 1 
\global\SectionCounter=0 \leavevmode \vskip20mm 
\removeindentfalse \ChTitle{#1} \removeindenttrue} 
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The command \supereject starts a new page, after forcing all the float- 
ing insertions out. To allow for the appearance of the \Chapter command 
within groups, the changes to the variables \ChapterCounter and \Section- 
Counter are made global. 

The command \leavevmode introduces a blank line before the introduc- 
tion of the vertical space. The command is needed because TEX removes 
vertical spaces that are introduced at the top of a page (as it does any space 
that is introduced after a breakpoint). 

The titles of the chapters are formatted by the following code. 


\font\ChapterFont=cmbx10 scaled \magstep5 
\def\ChTitle#1{{\ChapterFont \baselineskip=29.85pt . 
\advance\rightskip by Opt plus 0.7\hsize 
\noindent Chapter \the\ChapterCounter 
WskipiOmm \everypar{}/% 
\noindent \uppercase{#1}\bigskip}} 


The command \magstepS increases the size of the characters by a factor 
of (1.2)5, and the assignment of 29.85pt (= 12. (1.2)5pt) to Nbaselineskip 
increases the distance between the baselines in a similar proportion. The 
normal distance between the baselines is 12pt. The value of Mrightskip 
is adjusted to allow for ragged margins on the right, and so decrease the 
probability of getting hyphenated words in the titles. 

The paragraph that a title makes must be completed before leaving the 
braced group, because the values that \baselineskip and \rightskip hold 
at the end of the paragraph are the ones that count. This task is achieved 
here with \bigskip. 


Sections 


A definition similar to the one provided for \Chapter is also provided for 
the \Section command. 


\def\Section#1{\newbigskip 
\global\advance\SectionCounter by 1 
\removeindentfalse \SecTitle{#1}% 
\removeindenttrue} 


The titles of the sections are typeset as regular paragraphs, with the left 
margins adjusted to make a space for the level numbers. 


\font\SecFont=cmbx10 scaled \magstep3 
\def\SecTitle#1{{\SecFont \baselineskip=20.74pt 
\advance\rightskip by Opt plus 0.5\hsize 
\def\num{\the\ChapterCounter.\the\SectionCounter 
\hskip 0.7em}% 
\setbox0=\hbox{\num}¥, 


136 ENVIRONMENTS FOR WRITING 


\advance \leftskip by \wd0 
\parindent -\wd0 \everypar{}% 
\leavevmode \num #1 \par \nobreak \medskip}} 


The \par is inserted before the \nobreak to provide for a vertical mode 
before the \nobreak command. The point of the latter command is to prohibit 
a page break immediately after a title. 

The \Section command inserts vertical spaces around the titles to high- 
light them. It employs the commands \newbigskip and \medskip for such 
a purpose. The \newbigskip command is a variant of \bigskip. It replaces 
the existing vertical space with a vertical space of size \bigskipamount if the 
existing vertical space is smaller than \bigskipamount. 


\def \newbigskip{% 

\ifvmode \ifdim \lastskip<\bigskipamount 
\vskip -\lastskip \bigskip \fi 

\else \bigskip\fi} 


17.2 Blocks 


Some logical units, like displays and lists, are identified by commands that 
delimit them. The following pair of macros can be used for opening and 
closing local environments for the units, respectively, and for verifying that 
the delimiters appear in a well-behaved manner. 


\def \BeginEnv#i{\begingroup \def \EnvName{#1}} 
\def\EndEnv#i (// 
\ifx \EnvName\relax 
\warning{Environment #1 already closed}% 
\else 
\def\test{#1}% 
\ifx \test\EnvName \endgroup 
\else \warning{End environment #1 within 
environment \EnvName?}% 


\fi\fi} 


The command \BeginEnv opens a group that is named by the actual 
parameter. The command defines a local macro \EnvName for recording the 
name. The command \EndEnv tries to close a group whose name is provided 
by the actual parameter. When \EndEnv is invoked within a group that carries 
a name that differs from the actual parameter, it uses the following macro for 
issuing a warning message. 


\def \warning#1{\immediate\write16{1.\the\inputlineno 
-- warning -- #1}} 
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Example. The following commands start and end, respectively, an 
environment in which the margins are adjusted 1.5em inward. 


\def \Display{\BeginEnv{display}% 

\medskip \noindent 

\advance \leftskip by 1.5em 

\advance \rightskip by 1.5em) 
\def\EndDisplay{\medskip \EndEnv{display}} 


17.3 Lists 


Sequences of labeled items are called lists. We define the commands \List, 
\EndList, and \item for identifying the start of a list, the end of a list, 
and the start of an item within a list, respectively. The first command has 
one parameter for indicating the kind of labels that the items should carry, 
whereas the other two commands are parameterless. The actual parameter 
for the \List command can be the control sequence \num (numeric), \roman, 
\alph (alphabetic), or something else. 


Example of Source Text Corresponding Formatted Text 

\List{\alph} 

\item First paragraph of a. First paragraph of first item. 
first item. \par Second Second paragraph of first item. 


paragraph of first item. 


\item Second item. b. Second item. 


\List{\num} ; ! 
\item Item in embedded 1. Item in embedded list. 
list. 2. Another item. 
\item Another item. 
\EndList c. Yet another item. 
\item Yet another item. After the first list, and before 
\EndList the second one. 
After the first list, and 
before the second one. o Uhhh. 
\List{$\circ$} 
Mtem Uhhh. \item Ohhh. Sn: 
\EndList 


Definitions for the Commands 


The \List command opens an environment in which the left margin 
is moved inward, the paragraphs start without any indentation, and an ex- 
tra space is inserted between the paragraphs (see Fig. 17.1). The command 
\EndList closes the environment. 


138 ENVIRONMENTS FOR WRITING 


f \medskipamount 


Figure 17.1 List layout. 


\newcount\listcounter 
\def\List#1{\newmedskip 
\BeginEnv{List}%/ 
\advance \leftskip by 1.5em 
\listcounter=0 
\def\item{\par \leavevmode 
\parskip=4.5pt plus 1.5pt minus 1.5pt 
\advance\listcounter by 1 
\llap{#i\hskip 0.5em}}} 
\def \EndList{\newmedskip\EndEnv{List}} 


The control sequence \listcounter introduces a local counter that is 
initialized to 0 when a new list is started and increased by 1 when a new item 
is reached. Its value is restored when the end of a list is reached. 

When a new paragraph is encountered, TEX introduces before the para- 
graph an extra vertical space of magnitude \parskip. Within a given list, we 
want such extra spaces before all the paragraphs except the first one. 

The command \item inserts a label, which may depend on the value of 
\listcounter, to the left of the leading paragraph in each item. The nature 
of the label is determined by the actual parameter that the command \List 
receives. 


\def \num{\the\listcounter.} 

\def\roman{\romannumeral\listcounter.} 

\def\alph{{\advance \listcounter by 96 
\char\listcounter.}} 


The implementation of \List uses the following variant of the \medskip 
command. 
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\def\newmedskip{% — 
\ifvmode 
\ifdim \lastskip<\medskipamount 
\vskip -\lastskip \medskip \fi 
\else \medskip\fi} 


17.4 Cross-References 


Cross-references help readers locate information elsewhere in adocument. The 
cross-references can provide page numbers, section numbers, item markers, or 
other pointers indicating where the information is located. 

Creating cross-references manually can be a major task. This is in par- 
ticular true with systems that automatically assign page numbers, section 
numbers, and other markers, and in documents that undergo revision or are 
of nonnegligible length. Cross-referencing can be automated by letting the 
user refer to places and things indirectly through crosswords, then letting the 
system determine the appropriate pointers for the crosswords. To provide for 
such an environment, we define the commands \Tag and \Ref for tagging and 
referencing entities, respectively. 

The command \Tag takes the form ‘\Tag{a}{G}’, where a is a crossword 
and Ó is a token list. If the token list @ is empty, the command associates 
the current page number with the crossword a. Otherwise, the command 
associates the expansion ĝ of the token list @ with the crossword a. 

The command \Ref takes the form ‘\Ref{a}’, where a is a crossword. 
The command inserts into the formatted document the fragment of text that 
is associated with the crossword. 


Example of Source Text . \ChapterCounter 
\Tag{page}{} . \the\SectionCounter} 


This paragraph is located 
in Section” \Ref{section} ; 
and page" \Ref{page}. Corresponding Formatted Text 

This paragraph is located in 


\Tag{section}{\the Section 17.4 and page 139. 


Referencing Crosswords 


The implementations of \Ref and \Tag view the crossword a as a pointer 
to a macro that carry the name \cw@a. In addition, the commands assume 
that the body of this macro is the text fragment associated with the crossword. 

The \Ref command inserts the string ‘7???’ into the document and writes 
the warning ‘\Ref{a}?’ onto the terminal when the macro \cw@a (that is, 
the crossword a) is not known. On the other hand, when the macro is known 
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the command inserts an invocation to the macro. The command takes the 
following definition. 


\def \Ref #117, 

\expandafter\ifx \csname cw0#i\endcsname \relax 
\warning{\string\Ref \string{\string#1\string}?}%, 
\hbox{$??7$}% 

\else \csname cw0#1\endcsname Mil 


The construct ‘\csname cw0#1\endcsname’ produces an indirect refer- 
ence to the macro name \cw@a. When the macro name is undefined, the 
construct assigns to the indirect reference the meaning of \relax. 


Reference Files 


References to a crossword can appear before or after the definition of 
the crossword. The problem of resolving the forward references can be over- 
come by two consecutive compilations of the source document, where the first 
compilation collects the definitions for the second compilation. The following 
code introduces the channel for transferring the definitions between consecu- 
tive compilations. 


%---Read file from previous compilation--- 
\openin15=\jobname.ref 
\ifeof15 \immediate\writei6{No file Vjobname.ref]/ 


\else \input \jobname.ref 
\fi 

\closeini5 

¥--- Initiate file for writing --- 
\newwrite\refout 


\openout \refout=\jobname.ref 


The definitions of the crosswords are transferred from one compilation to 
another through an auxiliary reference file. For a source document ‘abc .Xyz!, 
the reference file carries the name ‘abc.ref’. At the start of a compilation, 
the reference file is read for the definitions that have been written into it 
during the previous compilation. Then the file is initiated for the writing of 
the definitions that are encountered during the current compilation. 

For each crossword a, the imported file contains a record of the form 
‘\CrossWord{aHÂHi}’. In such a record, B and i stand for the expanded 
token list and the page number that correspond to a, respectively. 


Example. The reference file contains the following code for the example 
on page 139. 

\CrossWord{page}{}{139} 

\CrossWord{section}{17 .4}{139} 
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The reference files also have to solve the problem of references to page 
numbers, because such numbers are not known when the \Tag commands are © 
encountered. These numbers are determined only when the page boundaries 
are determined, and the page boundaries are determined only after more text 
than can fit the pages is processed. 


Interpretation for Reference Files 


A command ‘\CrossWord{a}{GHi} i in the reference file introduces the 
macro ‘\def\cw0a{G}’ or the macro ‘\def\cwOati}’. 


\def\CrossWord#1#2#3{% 
\def\x{}¥, 
\def\y{#2}% - 
\ifx \x\y \def\z{#3}\else 
\def\z{#2}\fi 
\expandafter\edef\csname cw0#1\endcsname{\z}} 


The definition of \CrossWord must be inserted ahead of the command 
‘\input \jobname.ref’ that imports the reference files. 


Preparation of Reference Files 


A command ‘\Tag{a}{G}’ introduces into the reference file a record of 
the form ‘\CrossWord{a}{GHi}’. The definition of \Tag determines the ex- 
pansion B when the command is encountered and the page number i when 
the boundary of the page is determined. To this end, the definition takes 
into account the fact that the execution of the \write commands is delayed 
until the pages that contain them i is ready to be shipped out to the formatted 
documents. 


\def\Tag#1#2{\begingroup 
\edef\head{\string\CrossWord{#1}{#2}}%, 
\def\writeref{\write\refout}/, 
\expandafter \expandafter \expandafter 
\writeref\expandafter{\head{\the\pageno}}% 

\endgroup} 


The expanded definition of \head determines the prefix ‘\CrossWord{a} 
{ÂF of the record. The definition of \writeref and the \expandafter com- 
mands enable this prefix to be inserted into the text of the \write command. 


Higher-Level Tagging Commands 


To allow for a more user-friendly environment, we also introduce the com- 
mands \TagPage and \TagLoc. The first command takes the form ‘\TagPage{ 
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a}’, and it associates the current page number with the crossword a. The 
sécond command takes the form ‘\TagLoc{a}’, and it associates the mark of 
an item of a list, the section number, the chapter number, or the page num- 
ber with the crossword. The choice is for-the first option that applies for the 
command. 


\def\TagPage#1{\Tag{#1}{}} 
\def\TagLoc#i{% 
\ifnum \listcounter=0 % 
\ifnum \SectionCounter=0 
\ifnum \ChapterCounter=0 << tag page >D% 


\else 44 tag chapter >o% 
Mi 
\else 44 tag section >>% 
\fi 
\else 44 tag item pp\fi} 


This definition of \TagLoc employs four pseudocommands. The imple- 
mentations for the pseudocommands take the following forms. 


o The pseudocommand «« tag page >> stands for the following code. 
\TagPage{#1} 


o The pseudocommand «« tag chapter p> has the following implementa- 
tion. 


\Tag{#1}{\the\ChapterCounter} 


o The pseudocommand << tag section >> represents the following code. 


\Tag{#1}{\the\ChapterCounter .\the\SectionCounter} 


o The pseudocommand «a tag item p> corresponds to the following code. 


{\def\num{\the\listcounter}% 
\def\roman{\romannumeral\listcounter}/ 
\def\alph{\ifcase \listcounter 

\or a\or b\or c\or d\or e\or f\or 
g\or f\or g\or h\or i\or j\or k\or 
1\or m\or n\or o\or p\or q\or r\or 
t\or u\or v\or w\or x\or y\or z\else Mi 
\def\par##1\llap{}% 
\def\hskip##1em{}%, 
\Tag{#1}{\item}} 


17.5 Tables of Contents 


Tables of contents outline the content and organization of documents. Since a 
table of contents appears at the start of a document, each document requires 
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two compilations: one to collect the entries in the table, and one to incorporate 
the table into the document. 

A table of contents can be communicated from one compilation to an- 
other through an auxiliary file. The entries in the auxiliary file can take 
the forms ‘\chapter {a}{G}{i}’ and ‘\section (oHG, corresponding 
to the chapters and the sections in the document, respectively. The values 
a stand for the level numbers, the elements 8 stand for the titles, and the 
entities ? stand for the page numbers. ` 


Example. For this chapter, the adlais file would contain the follow- 
ing entries. 


\chapter {17}{Environments for Writing}{133} 
\section {17.1}{Divisions}{133} 
\section {17.2}{Blocks}{136} 


Listing the Entries 


For a source document that is stored in file ‘abc. xyz’, the table is stored 
in file 'abc.toc'. The folowing code generates a table of contents similar to 
the one for this book. 


\epeninie=\younamen bot 
\ifeof15 \immediate\writei6{No file \jobname.toc} 
\else 
\def\ChapNum#1{\bf \leavevmode\hbox to 1.7em{#1\hfil}} 
\def\SectNum#i{\rm \hbox to 2.5em{#1\hfil}} 
\def\PageNum#1{\hbox to 1.7em{\hfil #1}\par} 
\def\dotsfill{\leaders\hbox to 1em{\hfil.\hfil}\hfill} 
\def\chapter#1#2#3{\medskip 
\ChapNum{#1}\uppercase{#2}\hfill \PageNum{#3}} 
\def\section#1#2#3{\ChapNum{}% 
\SectNum{#1}#2\dotsfill\PageNum{#3}} 
{\parindent=0.0pt \input \jobname.toc \vfil} 
\fi \closein15 


The prefix ‘\leaders\hbox to 1em{\hfil.\hfil}’ of \nfill asks the 
command \hfill to fill the void with multiple copies of the horizontal box 
(instead of just white space). 


| 
i 


Collecting the Entries 


After the table of contents has been produced from the entries that have 
been collected in the previous compilation, a file is opened to collect the entries 
in the table from the current compilation. 
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\newwrite\tocout 
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\openout \tocout=\jobname.toc 


The following two commands are added to the definitions of \ChTitle 
and \SecTitle, respectively, in order to produce the entries for the table. 


\toc{\string\chapter{\the\ChapterCounter}{#1}}% 


\toc{\string\section{\the\ChapterCounter.\the 


\SectionCounter}{#1}}% 


The \toc command writes the expansion of its parameter and the page 


number into the file. 


\newtoks\tokwrite 
\newtoks\tokpage 


\tokwrite={\write\tocout} 
\tokpage={\the\pageno} 


\def\toc#1{% 


\edef\writetoc{\the\tokwrite{#i{\the\tokpage}}}% 


\writetoc} 


The expanded definition of \writetoc is introduced to achieve a write 
command ‘\write\tocout{#1{\the\pageno}}’ which expands the replace- 
ment of ‘#1’ according to the conditions that exist when the command is 
encountered. To avoid undesirable side effects from whatsits produced by the 
\write command, the \toc commands are inserted in horizontal mode. 


17.6 Figures with Captions 


Normally, figures consist of bodies and captions, and they can be referenced 
like other objects. We introduce here a command of the following form for 


producing such figures. 


\Figure(figure)\EndFigure{(crossword)}{(caption)} 


Example of Source Text 


\Figure \tt\noindent\hfil 
\vbox{\noindent 
\setbox0=\hbox{|------ 
\hsize=\wd0 


\EndFigure{where}{Here.} 


13% 


Where is Figure”\Ref{where}? 
Would you rather have ‘{\tt 
\string\vskip 1.5in}’ instead 
of the ‘{\tt \string\vbox 
\string{..... \string}}?? 


Corresponding Formatted Text 


Where is Figure 17.2? Would you 
rather have ‘\vskip1.5in’ instead of 
the ‘\vbox{..... p? 
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Figure 17.2 Here. 


The command can take the following implementation. The implementa- 
tion assumes that the code ‘\global\FigureCounter=0’ appears within the 
definition of \Chapter. 


\let\Figure=\topinsert 
\def\EndFigure#1#2{\medskip 
\topinsert 
\global\advance\FigureCounter by 1 
\hbox to \hsize{\hfil {\bf Figure 
\theFigureCounter} \rm #2\hfil}% 
\Tag{#1}{\theFigureCounter}% 
\endinsert} : 
\newcount \FigureCounter 
\def \theFigureCounter{\the\ChapterCounter 
.\the\FigureCounter} 


17.7 Bibliographies 
Three commands are offered for producing bibliographies. 


o \Bib(control sequence) {(key)}{(title)}. This command associates the con- 
trol sequence with the specified key. 


Example of Source Text Corresponding Formatted Text 


\Bib\bibI{key A}{Author Text of report with references to 
1. Title 1.} [key B,key C]. 

\Bib\bibII{key B}{Author 
2. Title 2.} 

\Bib\bibIII{key C}{Author 
3. Title 3.} 

Text of report with 

references to 

(\bibII,\bibIII]. 


o \ShowBib. This command asks that the referenced keys will be listed with 
their titles. The entries are listed in the order that the keys are introduced 
with the \Bib command. 
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Example of Source Text Corresponding Formatted Text 
\Bib\bibI{key A}{Author Text of report with references to 
1. Title 1.} [key B,key C]. 
\Bib\bibII{key B}{Author 
ao ee oo References 
\Bib\bibIII{key C}{Author [key B] Author 2. Title 2. 
3. Title 3.) [key C] Author 3. Title 3. 


Text of report with 
references to 
{\bibII,\bibIII]. \ShowBib 


o \BibByNum. This command asks that the keys in the \Bib commands will 
be replaced with integer numbers. It requires that the \ShowBib command 
will also be present, and it incorporates integer numbers accumulated in 
the previous compilation. 


Example of Source Text Corresponding Formatted Text 
\BibByNum Text of report with references to 
\Bib\bibI{key A}{Author [1,2]. 

1. Title 1.} R f 
\Bib\biblI{key BHAuthor eierences 

2. Title 2.) [1] Author 2. Title 2. 
\Bib\bibIII{key C}{Author [2] Author 3. Title 3. 

3. Title 3.) 


Text of report with 
references to 
[NbibII, bibIII]. \ShowBib 


The Implementation 


The \Bib command writes itself into a temporary file ‘bib.bib’, that 
is, it writes the record ‘\Bib(control sequence){(key)}{(title)}’. In addi- 
tion, the command associates with the control sequence an indirect reference 
‘\BibMark{(key)}’ to the key, and an indicator ‘\let\(characters of control 
sequence)=\def ined’ for telling when a reference to the key has been made. 


\newwrite\bibout 

\immediate\openout\bibout=bib.bib 

\newtoks\temptoks 

\def\Bib#1#2#3{% 
\temptoks={\Bib#1{#2}{#3}}% 
\immediate\write\bibout{\the\temptoks}% 
\def#i{\expandafter\glet\csname 

\string#1\endcsname=\defined \BibMark{#2}}} 
\def\glet{\global\let} \def\defined{defined} 
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The \BibByNum command asks that the given keys will be treated as tags 


for crossreferencing. 
i 
\let\BibMark=\relax 
\def\BibByNum{\let\BibMark=\Ref} 


The \ShowBib retrieves the file ‘bib. bib’ and lists the entries that have 
been referenced. 


\def\ShowBib{{\newbigskip \everypar{}% 
\immediate\closeout\bibout 
{\noindent \SecFont References}\par \nobreak \medskip 
Meftskip-2em \parindent=-\leftskip 
\def\Bib##i##2##3{ ..... n 
\input bib.bib \par }} 

\newcount\BibCount 


The file ‘bib.bib’ introduces the records ‘\Bib(control sequence) {(key)} 
{(title)}’ to the document, within a local environment in which \Bib lists 
those entries that have been referenced. Within the local environment, \Bib 
carries the following definition. 


\def\Bib##1##2##31{% 
\expandafter\ifx \csname\string##1\endcsname\defined 
\leavevmode 
\global\advance\BibCount by 1 
\Tag{##2}{\the\BibCount}¥, 
\setbox0=\hbox{ [\BibMark{##2}] }% 
\ifdim \wd0<\leftskip 
\setbox0=\hbox to \leftskip{\unhbox0\hfil}% 
\fi 
\box0 ##3\smallskip 
\fi} 


17.8 Indexes 


Making a nontrivial index is a labor intensive process consisting of the follow- 
ing steps (see Fig. 17.3). 
o Identifying the entries for the indexes. Two commands are offered for this 
task. 


e N-/ (major entry)//(tag)/ (format)/. This command asks to include a 
major entry (major eniry) in the index, formatted according to the 
conventions made for (format) and referencing the page numbers asso- 
ciated with (tag). 

e N-/ (major entry)/(secondary entry)/(tag)/(format)/. This command 
is a variant of the previous one for including secondary entries. 
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Example of Source Text Corresponding Formatted Text 
\def\.{\nu11\vfill\break} Index 

\input miniWriTex.sty 

\-/entry A//e1// entry A, 2, 4-6 

\-/entry A/subentry/e.1// subentry, 5 

\--e2.2// \. \--ei// \. entry B 

\--e2.2// \. \--e1/</ \. subentry B.1, 7 

\--e.1// \. \-ret/>/ \. \subentry B.2, 1, 3 


\--e2.1// \-/entry B//// 
\-/entry B/subentry B.2/e2.2/0/ 
\-/entry B/subentry B.1/e2.1/1/ 
\def\UserEntry#1#2{% 

\ifcase #1 

{\tt\char92 Nit #2}% 0 
\or{\bf #23% 1 
Mi } \Index 


Corresponding idx file Corresponding xdi file 


\-/entry A//e1// \--entry A//, 2, 4--6// 
\-/entry A/subentry/e.1// \--entry A/subentry/, 5// 
\--e2.2//1/ \--entry B//// 

\--e1//2/ \--entry B/subentry B.1/, 
\--e2.2//3/ 7/1/ 
\--e1/</4/ \--entry B/subentry B.2/, 1, 
\--e.1//5/ 3/0/ 
\--e1/>/6/ 

\--e2.1//7/ 

\-/entry B//// 

\-/entry B/subentry B.2/e2.2/0/ 

\-/entry B/subentry B.1/e2.1/1/ 


Figure 17.3 An index and its files. 


o Identifying the locations that should be referenced by the entries. Three 
commands of similar nature are offered for this purpose. 


e \--(tag)//. This command associates the current page number with 
the specified tag. 


e \--(tag)/</. This command associates a range of page numbers with 
the specified tag, starting at the current page. 


e \--(tag)/>/. This command terminates the range of page numbers 
started with a \--(tag)/</ command. 
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o Sorting and merging the entries of the index. TpX can do the job but 
in an amount of time that has no practical value. Hence, external tools 
should be employed for this phase (the author uses the sort command of 
Unix for sorting and a short awk program for merging). It is assumed here 
that the external tools get a file named ‘\jobname.idx’ for an input and 
provide the processed index in a file named ‘\jobname.xdi’. 


o Typesetting the index into the document. The next command performs 
this tak. 


e \Index. This command imports the file ‘\jobname.xdi’ into the doc- 
ument, if the file exists. The file should consists of entries that have 
the following form. 


\--(major entry)/ (secondary entry)/ (page numbers) /(format)/ 


The different fields, except for the first one, can be empty. An empty 
field (format) asks that the entry will be processed according to the 
default setting. A nonempty (format) asks that a two-parametric 
user-defined command ‘\UserEntry{(format)}{(major or secondary 
entry)?! will typeset the entry. 


The Implementation 


The ‘\--...’ and ‘\-/...’ commands collect the entries into file ‘\job- 
name.idx’. 
\newwrite\idx 


\openout \idx=\jobname. idx 


The character that follows the prefix ‘\-’ determines which of the two 
commands, if any, is to be activated. 


\def\IdxEntry/#1/#2/#3/#4/{%, 
\write\idx{\string\-/#1/#2/#3/#4/}} 

\def \IdxPage-#1/#2/{%, 
\write\idx{\string\--#1/#2/\the\pageno/}} 

\let\ControlMinus=\- 

\def\-{\futurelet\CheckMinus\DoMinus} 


\def\DoMinus{%, 
\ifx \CheckMinus/ \let\next=\IdxEntry 
\else\ifx \CheckMinus- \let\next=\IdxPage 
\else " Met NnextzNControlMinus 
\fi\fi \next } 


The \Index command imports the file containing the processed entries, 
after setting a local environment and ‘\-~’ to handle the incoming entries. 


150 ENVIRONMENTS FOR WRITING 


\def\Index{%, 
\def \--##1/##2/##3/##4/{7, 
\def\temp{##2}% 
\ifx \temp\empty \par \def\next{##1}% 
\else 
\hfill\break\null\hskip-0.5\leftskip 
\def\next{##2}\fi 
\def \temp{##43% 
\ifx \temp\empty \next 
\else \UserEntry{##4}\next 
\fi 183) 
\openin15=\jobname. xdi 
{\ifeof15 \else 
\newmedskip {\noindent\SecFont Index}\par \nobreak 
\medskip \TwoColumns \leftskip =2.8em 
\parindent=-\leftskip \rightskip=0pt plus 1.6in 
\everypar{}\input \jobname.xdi \EndTwoColumns }\fi} 
\def \UserEntry#1#2{#2} 


17.9 Style Libraries and LaTẸX 


Macros like the ones that are offered in this chapter can be assembled into 
libraries that are stored in auxiliary files. Each library can be considered to 
be a specification for a document style, and can be imported into the start of 
a source document with the \input command. 

There are several advantages of style libraries. One obvious advantage is 
that such libraries support the philosophy of separating issues of content and 
organization from issues of style. Another obvious advantage is the ability 
to share macros among different applications, thus reducing the investment 
needed to prepare macros. 

Shared libraries encourage uniformity of style among different documents 
of similar kinds. Furthermore, as the libraries are reused, they repeatedly 
undergo scrutiny and revision, and so as time passes more polished styles of 
documents evolve. 

In what follows, we use the name miniWriTpX to refer to the library that 
contains the features of this chapter. 


LaTeX 


LaTgX is probably the most widely available enhancement of TEX. The 
table in Fig. 17.4 shows a few LaTgX commands, and their corresponding 
meaning in miniWriTgX. 

A user of LaTpX needs to invoke TpX indirectly. For instance, the author 
uses the command ‘latex abc.nm’ instead of the command ‘tex abc.nm’ to 


EXERCISES m 151 


LaTeX mini Wri TFX Comments 
\documentstyle{(style)} \input miniWriTex.sty (style) stands for 
\begin{document} (content) article, report, 
(content) \bye or book 
\end{document} 
\chapter{(title)} \Chapter{(title)} 
\section{(title)} \Section{(title)} 
\begin{enumerate} \List{(type of labels)} (type of labels) 
(stems) (stems) stands for \nun, 
\end{enumerate} \EndList \alph, or \roman 
\begin{itemize} \List{(type of labels)} (type of labels) 
(items) (items) stands for 
\end{itemize} \EndList $\bullet$ or some 
other symbol 

\item \item 
\begin{figure} \Figure 
(figure) (figure) 
\caption{ (title)} \EndFigure{(crossword)}{(title)} 
\label{(crossword)} i 
\end{figure} ' 

\TagLoc{(crossword}} For object 
Visbebtiomdtuoayy \TagPage{(crossword)} For page number 
\ref{(crossword)} For object 


\Ref {(crossword)} 


\pageref{(crossword)} For page number 


Figure 17.4 LaTgX and mini WriTEX. 


compile a source file ‘abc.nm’ with LaTEX instead of TEX (the extension ‘.nm’ 
is optional when nm=tex). 


Exercises 


17.1.1 Modify the definition of \SecTitle so that it will not allow page 
breaks within the title. 

17.1.2 Define a command named \SubSection for dividing sections into 
subsections. 

17.2.1 How will the meaning of \Display be changed if ‘\medskip \noin- 
dent’ is moved so that it appears after the \advance commands? 

17.3.1 Write a parameterless macro \AutoList that acts like the commands 
‘\List{\alph}’, ‘\List{\num}’, ‘\List{\roman}’, and ‘\List{$\circ$}’ for 
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lists at 0, 1, 2, and higher levels of nesting, respectively. 


17.4.1 More than one \Tag command can refer to the same crossword a, 
but ‘\Ref{a}’ produces only the information that the last of these commands 
associates with a. Modify \CrossWord so that ‘\Ref{a}’ will provide all the 
pieces of information that the \Tag commands associate with a. 


17.4.2 Explain the following source text. 


\openin15=ref .ref 
\def\entry#1#2{\expandafter\def\csname 
*#1\endcsname{#2}} 
Mifeofi5 \else \input ref.ref \fi 
\def\ref#i1{\csname *#1\endcsname} 
\closeini5 
\openout15=ref .ref \newcount \diff 
\def \tag#1{\writei5{\string\entry{#1}{\the\pageno}}} 
\def\refs#1#2{{% 
\setbox0=\hbox{\global\diff=0\ref {#2} 
\global\advance\diff by -0\ref{#i} 3% 
\ref{#1} \ifnum \diff>1 through \else 
and \fi \ref{#2}}} 
\tag{a} \refs{a}{b}\par\vfil\break 
\tag{b} \refs{a}{c}\par\vfil\break \tag{c} 


17.5.1 Make the necessary modifications so that no page break will be al- 
lowed in a table of contents after entries that refer to chapters. 


17.9.1 Choose a topic of your liking (for instance, traveling or cooking) and 
prepare a style library for reports on that topic. 


APPENDIXES 


Appendix A 


MORE ON SYMBOLS 
AND CHARACTERS 


Accessing symbols and controlling their placement are two major functions 
of text formatting. TEX enables very fine control over these functions within 
two environments, namely, within an environment for ordinary text and an 
environment for mathematical text. This appendix studies further features 
that deal closely with these functions. Specifically, the first section of this 
appendix introduces new control sequences for producing adjustable delimiters 
in formulas, the second looks at subscripts and superscripts that have varying 
behavior, and the third deals with subformulas that are stacked one on top 
of the other. The fourth section offers additional insight into fonts, and the 
concluding section considers different types of codes that are associated with 
characters. 


A.1 Delimiters 


Delimiter symbols are distinguished from other symbols in the sense that we 
can ask that they adjust their sizes to the dimensions of the subformulas that 
they enclose. The delimiters can be introduced with the following commands. 


Delimiter Names 


\{,\lbrace. { (oat Less ( Mfloor .... | \backslash. \ 
\},\rbrace. } Jer rens ) \rfloor .... | Jeena / 
\langle .... ( Dereitos [ \lceil...... [ A | 
\rangle .... ) Data chases. ] \rceil...... ] Nl ataia ll 


We ask for adjustable delimiters by inserting the control sequence \left 
before a left delimiter and the control sequence \right before a right delimiter. 
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Example of Source Text Corresponding Formatted Text 
$[(N! \over (el? 

k!(N-k)!)172$ \par m à 
$\left[{N! \over [ea | 


k! (N-k) !}\right] “2$ 


The control sequences \left and \right must appear in pairs within 
each math formula. That is, the two control sequences must appear the same 
number of times, and at no point there should be more \right than \left 
control sequences. If we do not want a left delimiter or a right delimiter to ap- 
pear, we can insert the \left command or the \right command, respectively, 
with the period character ‘.’ instead of a delimiter. 


Example of Source Text Corresponding Formatted Text 
$\left.{\partial y(t,x)\over by(t,2) 


; 2 
\partial x} \right|_{x=0} $ 97 |e=0 [Dai /3721] 
$\left\lfloor \sum x_i \left/ 

\sum x i^2 


\right .\right\rfloor$ 


As a side effect, each matching pair of control sequences \left and 
\right defines a group for the subformula that they enclose. 


Example of Source Text Corresponding Formatted Text 
${a\over b}\left / c\over d ejs 
\right.$ 


A.2 Superscripts and Subscripts 


On some symbols, superscripts and subscripts assume different positions in 
displayed math mode than in math mode. Such is the case, for instance, 
when the superscripts and subscripts are placed on the operation symbols 


A (\bigwedge), V (\bigvee), U (\bigcup), N (\bigcap), >> (\sum), [I 
(\prod), and f (\int). 


Example of Source Text Corresponding Formatted Text 
$\sum_{i=1}°n c_i z^i$ Di cz 
$$\sum_{i=1}^n c_i z^i$$ Ya 
í-1 


Similarly, this is also the case for subscripts that are placed on function 
symbols produced with the commands \det, \gcd, \inf, Mim, \limitinf, 
\limsup, Wax, \min, \Pr, and \sup. 
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Example of Source Text Corresponding Formatted Text 
$\max_{1\leq j\leq n}a_{ij}$ MAX1<j<n lij 


$$\max_{1\leq j\leq n}a_{ij}$$ DAE. Qij 


The ‘\overbrace{(formula)}’ and 'Nunderbracei(formula)) commands 
produce in math mode horizontal braces over and under their parameters, re- 
spectively. Labels can be placed on the horizontal braces with the superscripts 
and subscripts operations. 


Example of Source Text Corresponding Formatted Text 
$\underbrace{a\cdots a m 
' \overbrace{b\cdots b)^m a-::ab--.ba--.-a 
— P — 


a\cdots aj n$ 


A.3 Stacking Commands 


The following commands are variants of the \over command. They partition 
a formula within a group into two, and put the first subformula vertically 
over the second subformula. These new commands differ from \over with 
respect to whether or not they insert a fraction bar between the parts and 
with respect to whether or not they put parentheses around the text. 


o \above(dimension). This command is a variant of \over which gets the 
thickness of the fraction bar for a parameter. 


Example of Source Text Corresponding Formatted Text 
${a \over b) \above ipt c$ 


a let 


o \atop. This command acts like \over, but it does not insert a fraction 
bar. 


Example of Source Text. — Corresponding Formatted Text 
$\left\{ l ns ae { 2e+3y=1 
{3x+5y=1\atop 2x+3y=0} an raya? Mri 


\qquad{\rm or}\qquad 
\right\{ {2x+3y=1\atop 
5x+7y=3}$ 


o \choose. This command is a variant of the \over command that inserts 
parentheses around the stacked subformulas instead of inserting a fraction 
bar between them. 


Example of Source Text l Corresponding Formatted Text 
= b 
$A- (aX b\choose c\ d}$ A= (25 
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Each stacking command puts its subformulas in horizontal boxes. The 
boxes carry the width of the wider subformula, and the shorter subformula is 
centered in its box with \hfil commands. 


Example of Source Text Corresponding Formatted Text 
$|x|=\left\f æj _ es if z«0 
HY z otherwise 


{-x \atop x} \quad 
{{\rm if}\ x<0 \atop 
\rm otherwise} \right.$ 


We can shift the shorter subformulas horizontally with the \hfil and 
\hfill commands. 


Example of Source Text Corresponding Formatted Text 
$|x|-MeftM jæ] = fee if <0 
{-x \atop \hfill x} \quad gi otherwise 


{{\rm if}\ x<0\hfill \atop 
\rm otherwise} \right .$ 


A.4 Fonts 


In Chap. 4 we saw how one can control the fonts in ordinary text. Controlling 
fonts in math mode is more complicated, and we consider this topic here. 


Changes within Math Mode 


By introducing changes of our own to fonts in formulas, we interfere with 
the TgX mechanism that automatically handles changes of fonts for formu- 
las. We can force a change between regular, small, and tiny sizes of symbols 
with the commands \textstyle, \scriptstyle, and \scriptscriptstyle, 
respectively. 


Example of Source Text Corresponding Formatted Text 


$X ^X \scriptstyle XXX iti-[£| 
X ^i \textstyle X} \quad "EU 
\left|a\over b\right |= 
\left|\textstyle a\over 

\textstyle b\right|$ 


And we can change between different layouts of the symbols. We can get 
standard text fonts with the commands \rm, \bf, Vit, \sl, and \tt. Or we 
can switch into special math fonts with the commands \mit and \cal. 


Example of Source Text Corresponding Formatted Text 


$\mit 0123456789 \quad 0123456789 0123456789 
\rm 0123456789$ 
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"Fr 
oo 


Q 


^ 
^ 


Figure A.1 Output table for \teni. 


The command \mit refers to the font with the appropriate size among 
the math italic fonts \teni, \seveni, and \fivei for regular, small, and tiny 
sizes, respectively. Similarly, the command \cal refers to the math symbol 
fonts \tensy, \sevensy, and \fivesy, respectively. On the other hand, in 
math mode the command \rm refers to the fonts \tenrm, \sevenrm, and 
\fiverm, respectively. The symbols of font \teni are shown in Fig. A.1, and 
the symbols of font \tensy are shown in Fig. A.2. 


Example of Source Text Corresponding Formatted Text 


$ \rm rm\ \mit mit rm mit!" mit 
^(Nrm rm\ \mit mit}$ 


Within math mode, the commands \rm, \bf, Vit, \sl, \tt, \mit, and 
\cal offer us access to only some of the symbols in the fonts that they activate. 
Outside math mode, we can access all the symbols of these fonts. 


Example of Source Text Corresponding Formatted Text 
{\tensy CALLIGRAPHY!\chari26} CALLIGRAPH)—9 
$\tensy!$ $\hbox{! \tensy!}$ oes 


\tensy $\hbox{!}$ 
In its default form, the math mode takes its letters from the math italic 
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o 


"rre 
"rrr bee 
"Febre 
Pret ere DET: 
secre eS NY EE 
eect lel ble 


i 
Figure A.2 Output table for \tensy. 


font and its digits from the roman font. 


Example of Source Text Corresponding Formatted Text 

Italic: $\it fit\ diff.$\par Italic: fit diff. 

Math italic: $fit\ diff.$ Math italic: fit dif f. 
Loading 


When starting to work on a document, TpX loads fonts with the following 
commands. The math extension font \tenex holds the large math symbols 
and the pieces from which the symbols that have adjustable sizes are built. 


MontNtenrm-cmriO0 \font\sevenrm=cmr7 \font\fiverm=cmr5 
\font\tenbf=cmbx10 \font\sevenbf=cmbx7 \font\fivebf=cmbx5 
\font\tensl=cms110 
\font\tenit=cmti10 
\font\tentt=cmtt10 
\font\teni =cmmii0 \font\seveni =cmmi7 \font\fivei =cmmi5 
\font\tensy=cmsy10 \font\sevensy=cmsy7 \font\fivesy=cmsy5 
\font\tenex=cmex10 


Besides loading the fonts, TX also inserts the following pair of assign- 
ment instructions. The first assignment sets the distance between the base- 
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lines of succeeding text lines to be compatible with symbols of size 10 points. 
The second assignment indirectly sets \strut to insert an imaginary character 
with the specified dimensions (see Sec. C.1 for the meaning of \vrule). 


\newbox\strutbox \baselineskip=12pt 
\setbox\strutbox=\hbox{\vrule height 8.5pt 
depth 3.5pt width Opt} 


Example of Source Text Corresponding Formatted Text 
\def\x#1{\par 0.0pt 0.0pt 
\setbox0=\hbox{#1}% 0.0pt 1.05554pt 


\the\dp0\qquad \the\nt0} 0.0pt 4.30554pt 


\x{ }\x{.}\x{a}\x{(}\x{\strut} 2.5pt 7.5pt 
3.5pt 8.5pt 


The \strut command comes in handy when we want to get lines of text 
with uniform heights and depths, as well as when we want to get some vertical 
spaces around the lines. For instance, the command can improve the vertical 
spacing around vertical boxes, when it is inserted into the opening and closing 
lines of the boxes. 


Example of Source Text Corresponding Formatted Text 
\def \x#1{\vbox{% : Watch the ver- 
\hsize= 64pt à tical spaces. 
#iWatch the Watch the ver- 
vertical spaces.iti1)) tical spaces. 
\x{}\x{}\x{\strut} Watch the ver- 
\x{\strut} tical spaces. 
Watch the ver- 


tical spaces. 


Styles and Families 


At this stage we can use only the commands \tenrn, \sevenrm, \fivernm, 
\tenbf, \tensl, \tenit, \tentt, \teni, \seveni, \fivei, \tensy, \sev- 
ensy, \fivesy, and \tenex for accessing fonts. Moreover, we can use the 
commands only for changing fonts in ordinary text, because the math mode 
ignores the commands that \font defines. 

To allow access to these fonts in math mode, we need to associate them 
with styles and families. The fonts can be associated with normal math style, 
with first-level subscript and superscript style, and with higher levels of sub- 
script and superscript style. 

TEX employs the \textfont, \scriptfont, and \scriptscriptfont 
commands in the following manner to associate the above fonts with styles 
and families. The fonts are associated with families that carry the names ‘0’, 
‘1’, ‘2’, ‘3’, \bffam, \slfam, \itfam, and \ttfan. 
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\textfont0=\tenrm \scriptfont0=\sevenrm 
\textfonti=\teni \scriptfont1=\seveni 
\textfont2=\tensy \scriptfont2=\sevensy 
\textfont3=\tenex \scriptfont3=\tenex 


\textfont\bffam=\tenbf \scriptfont\bffam=\sevenbf 
\textfont\slfam=\tensl \scriptscriptfont0=\fiverm 
\textfont\itfam=\tenit \scriptscriptfont1=\fivei 
\textfont\ttfam=\tentt \scriptscriptfont2=\fivesy 
\scriptscriptfont3=\tenex \scriptscriptfont\bffam=\fivebf 


To activate a font within math mode, we need to activate the style of the 
font and the family of the font. The different styles can be activated with the 
commands \textstyle, \scriptstyle, and \scriptscriptstyle, respec- 
tively. A family (family) can be activated with the command ‘\fam=(family)’. 


Example of Source Text Corresponding Formatted Text 
$\fam=1 cmmii0 \scriptstyle CMM110emmizemmis 
cmmi7 \scriptscriptstyle embxsembx7e¢mbx 10 


cmmi5\break \fam=\bffam cmbx5 
\scriptstyle cmbx7 
\textstyle cmbxiO $ 


We get an error if we try to activate a style-family combination for which 
no font is defined. For instance, we get an error if we try to enter style 
\scriptstyle in family \slfam. 

The command ‘\newfam(family)’ creates a new family of fonts, where the 
name (family) that is chosen for the family must be a control sequence. 


Example of Source Text Corresponding Formatted Text 


\newfam\uni aè? ab 
\textfont\uni=\tenrm 
\scriptfont\uni=\tenrm 
\scriptscriptfont \uni=\tenrm 

$a^ib^c) \fam=\uni\ a*{b*c}$ 


Math Character Codes 


Besides their character codes and category codes, TEX characters also 
have math codes. The math code of a given character determines the family 
that in math mode will contribute the symbol for the character. For instance, 
in math mode TFX takes from family 0 the symbols for the characters ‘C, ‘)’ 
‘=’, and ‘?’. It takes from family 1 the symbols for the characters ‘.’, ‘>’, 
and ‘<’. It takes from family 2 the symbols for the characters ‘|’, ‘*’, and ‘~’. 
And so forth. 

To some characters, TEX assigns default families that are activated when 
Afam--1'. For instance, the character ‘A’ in the default setting gets its sym- 
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bols from family 1, and as \fam changes its values, the character changes the 
families from which it draws its symbols. 


Example of Source Text Corresponding Formatted Text 
\def\x#1{$\fam=#1 AB(ab)$} AB(ab) AB(ab) AB(ab) 
\x{\bffam} \x{\slfam} AB(ab) P M AB(ab) 
\x{\itfam} \x{\ttfam} \x{-1} AB(4|) 1! 

\x{0} \x{1} \x{2} \x{3} JHI 


When TEX enters math mode, the font associated with style \textstyle 
of family -1 is the one that is active. 


General Commands 


The \fam command is ignored within ordinary text, in the same way that 
the internal names of the fonts are ignored within math mode. TẸX gives the 
following definitions to the \rm, \bf, \s1, \it, and \tt commands, to allow 
for a uniform manner of access to their corresponding fonts inside and outside 
math mode. 


\def\bf{\fam=\bffam\tenbf} \def\sl{\fam=\slfam\tens1} 
\def\it{\fam=\itfam\tenit} \def\tt{\fam=\ttfam\tentt} 
\def\rm{\fam=0\tenrm} \def\mit{\fam=1} \def\cal{\fam=2} \rm 


The commands are not themselves names of fonts, even though we were 
led earlier to believe that they are internal names of fonts. Instead, they 
indirectly refer to internal names of fonts. 


Example of Source Text Corresponding Formatted Text 


\font\twelverm=cmr12 emrl0xxx, cmrl2xxx, xxx. 
\def\rm{\fam=0 \twelverm} 
\fontname\font $\rm xxx$, 
\rm \fontname\font $\rm xxx$, 
\textfont0=\twelverm $\rm xxx$. 


Accents and More 


TEX offers also the following definitions for commands that set accents 
on characters. The definitions determine the correct positions for the accents. 


\skewchar\teni =127 \skewchar\tensy =46 
\skewchar\seveni=127 \skewchar\sevensy=46 
\skewchar\fivei =127 \skewchar\fivesy =46 


Changes in fonts may also require changes in the values of some variables 
like \baselineskip, \lineskip, \lineskiplimit, \normalbaselineskip, 
\normallineskip, \normallineskiplimit, \smallskipamount, \medskip- 
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amount, \bigskipamount, \abovedisplayshortskip, \belowdisplayshort- 
skip, \abovedisplayskip, and \belowdisplayskip. 


A.5 Codes for Characters 


TX constructs that behave like integer variables but cannot be assigned val- 
ues in arithmetic expressions are called here pseudovariables. 


Character Codes 


The constructs ‘ ‘(character)’ and ‘ ‘\(character)’ give the character code 
of the specified character at locations where TEX expects to find integer values; 
the constructs are meaningless at other locations. 

The following command defines a pseudovariable and stores the specified 
character code within the pseudovariable. The pseudovariable provides its 
value at locations where TgX expects to find integer values. At other locations, 
the pseudovariable produces the symbol, in the current font, that is associated 
with the character code. 


\chardef (control sequence)=(character code) 


Example of Source Text Corresponding Formatted Text 


\chardef\x=‘\x The symbol The symbol ‘x’ corresponds to char- 
‘\x? corresponds to character acter code 120. Here is another sym- 
code \the\x. Here is another bol, 2. 

symbol, \chardef\x=10 \x. 


Applications that are sensitive to time and memory resources quite often 
take advantage of the \chardef command to create control sequences that 
record integer constants in the range of zero to 255. 


Example of Source Text Corresponding Formatted Text 
\newcount\c \chardef\vii=7 14 

\c=\vii \advance\c by \vii 

\the\c 


Math Character Codes 


Each character has a pseudovariable ‘\mathcode(character code)’ that 
holds an integer number, where the number is called math character code. 


Example of Source Text Corresponding Formatted Text 


\mathcode‘ \x=30 30. 
\mathcode‘ \y=\mathcode ‘\x 
\relax \the\mathcode‘\y. 
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A value that is stored in a given pseudovariable ‘\mathcode(character 
code)’ offers the specification for the symbol in math mode that corresponds 
to the character that has character code (character code). A math character 
code must be an integer value in the range of zero to 32767, whereas in 
hexadecimal representation the number gets the following interpretation. 


"(class digit) (family digit) (two-digit character code) - 


The (class digit) can be 0 (ordinary symbol), 1 (large operator), 2 (binary 
operation), 3 (relational operation), 4 (left delimiter), 5 (right delimiter), 6 
(punctuation mark), or 7 (adjustable). 


Example of Source Text Corresponding Formatted Text 

\tt \meaning\alpha, \mathchar"10B, \mathchar"1353, 
\meaning\bigcup, \mathchar"2202, 
\meaning\times, ' \mathchar"3214. 
\meaning\subset. 


Class 7 asks that the specified symbol come from family (family digit) 
when \fam is equal to minus one, and from family \fam when \fam is equal 
to a nonnegative integer value. In all other respects, math symbols of class 
7 are treated in the same manner as math symbols of class 0. The letters of 
the English alphabet are initialized to hold math character codes of class 7. 


Example of Source Text Corresponding Formatted Text 


\def\x{{\mathcode‘\*="0203 #}} **%* x, 111, 1*1. 
$e x x$, $\x * \x$. 

\def\x{{\mathcode‘\1="2203 1}} 

$1 1 1$, $1 \x 1$. 


The following is a variant of the \chardef command. It defines a pseu- 
dovariable that produces the specified symbol in math mode at locations where 
TEX expects to encounter a symbol, and produces the specified number at lo- 
cations where TEX expects to encounter an integer value. 


\mathchardef (control sequence) (math character code) 


Example of Source Text Corresponding Formatted Text 


\mathchardef\x="2203 $\x$: *: 8707. X: 17414. 
\the\x. \newcount\c \c=\x 

\advance\c by\c 

\mathchardef\x=\c $\x$: \the\x. 


Category Codes 


A construct ‘\catcode(character code)’ is a pseudovariable that holds 
the category code of the specified character. The pseudovariable can be the 
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recipient of a value in assignment commands, and it can be the provider of 
values at locations where TFX expects to find integer values. 


Example of Source Text Corresponding Formatted Text 


\newcount\c \catcode‘\*=13 13, 26 
\catcode‘\+=\catcode‘\* 
\c=\catcode‘\+ 

\advance\c by\catcode‘\+ 
\the\catcode‘\+, \the\c. 


The command \active is the name of a pseudovariable defined with 
\chardef to hold the integer constant 13. 


Example of Source Text Corresponding Formatted Text 


\catcode‘\A=\active Aaa. 
\defA{\stringAaa} A. 


Lowercase and Uppercase Character Codes 


Each character receives a lowercase code and an uppercase code, along 
with the character code, the category code, and the math code that it receives. 
These new codes are stored in pseudovariables that carry the following names. 


\lccode(character code) 
\uccode(character code) 


Example of Source Text Corresponding Formatted Text 


\uccode‘ \*=15 15. 
Nuccode \a=\uccode‘ \* 
\the\uccode Na. 


The pseudovariables can be assigned only values that are character codes, 
that is, values in the range of zero to 255. Initially, the pseudovariables 
‘\lccode(character code)’ that correspond to letters hold the character codes 
of the “natural” lowercase letters, and the pseudovariables ‘\uccode(character 
code)’ that correspond to letters hold the character codes of the “natural” 
uppercase letters. The rest of the pseudovariables are initialized to zero. 


Example of Source Text Corresponding Formatted Text 


\the\lccode‘\A, A: 97, a: 97, A: 65, a: 65, @: 0, @: 
\the\lccode‘\a, 0. 

\the\uccode‘\A, 

: \the\uccode‘\a, 

: \the\lccode‘\@, 

: \the\uccode‘\@. 


een rv > 
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These pseudovariables can be employed to determine whether given let- 
ters are uppercase or lowercase letters. l 


Example of Source Text Corresponding Formatted Text 
\def\lc#1{#1: A: uppercase, a: lowercase. 
\ifnum‘#1=\lccode‘#1 
lowercase\else 
uppercase\fi} 


Mc A, Mc a. 


The next commands, and the hyphenation algorithm of TEX, consult the 
pseudovariables ‘\lccode(character code)’ and ‘\uccode(character code)’. 


o \lowercase{(token list)}. This command replaces each character token 
in (token list) with a new character token. The new character tokens are 
obtained from the old character tokens by replacing the character codes 
(character code) in the old character tokens with the character codes that 
are stored in the pseudovariables ‘\1ccode(character code)’. 


No replacement takes effect when a pseudovariable 'N1ccode(character 
code)’ holds a zero value. On the other hand, the new tokens inherit 
the category codes of the old tokens. l 


Example of Source Text \def? {+++} 
Mtt \lccode‘\?=‘\* 7 \lowercase{X?X}, X?X. 


\lowercase{X7X}, X?X. 
\catcode‘\*=13 \def*{...} 
\catcode‘\*=11 
\catcode‘\?=13 X*x, X?X. x...x, Xte*X. 


Corresponding Formatted Text 


The \lowercase command allows implicit left braces for delimiters, and 
these implicit left braces can be embedded within other constructs. No 
expansion of tokens is performed for a \lowercase command after its left 
delimiter is encountered. 


Example of Source Text  . Corresponding Formatted Text 


\tt \lccode‘\?=‘\* 7 X*XX*xX?X. 
\def\t{\bgroup X?X) —— 
\lowercase\t X?X\t\egroup}. 


o \uppercase{(token list)}. This command replaces character codes within 


character tokens according to the mappings that are defined by the pseu- 
dovariables ‘\uccode(character code)’. 


Example of Source Text Corresponding Formatted Text 


\romannumeral 123, exxili, CX XIII. 
\uppercase\expandafter{/, 
\romannumeral 123}. 


Appendix B 


MORE ABOUT TpX 


This appendix consists of three sections, which deal with boxes, with features 
for gathering information in pages, and with breakpoints in lines and pages, 
respectively. 


B.1 Boxes 


Chapter 10 introduced us to the features of boxes, and the end of Sec. 12.3 
introduced us to a few features for inquiring about the dimensions of boxes. 
This section elaborates further on these topics. 


Widths 


The width of a horizontal box is either specified explicitly in the definition 
of the box or determined implicitly by the box’s content when no specification 
is given. 

The width of a vertical box is determined by the width of its content. 
The content can consist of paragraphs and of other boxes that are inserted 
in vertical mode. When a vertical box contains only boxes (all inserted in: 
vertical mode), it assumes the width of the widest of these boxes. 


Example of Source Text Corresponding Formatted Text 
Before--\vbox{ Wider box. 
\hbox{Wider box.} Before-Box. —After. 


\hbox{Box.}}--After. 


The values that the variable \hsize holds do not directly affect the ver- 
tical boxes. These values just determine the widths of the paragraphs, which 
in turn may determine the widths of the boxes. 
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Example of Source Text : Corresponding Formatted Text 
Before--\vbox{\hsize=9in Wider box. 
\hbox{Wider box.} l Before-Box. —After. 


\hbox{Box.}}--After. 


Shifted Boxes 


We can raise, lower, shift left, or shift right a box (boz) to a distance 
(dimension) with commands of the following form. 
\raise (dimension) (boz) 
\lower (dimension) (boz) 
\moveleft (dimension) (boz) 
\moveright (dimension) (boz) 


The first pair of commands apply only in horizontal mode, and the last 
two commands apply only in vertical mode. 


Example of Source Text Corresponding Formatted Text 
\noindent \raise 15pt Raised box 
\hbox{Raised box} and and 
\lower 15pt \hbox{lowered 
lowered box. 


box.} 
New Variants 


Within math mode we can also define vertical boxes with the \vcenter 
command, in the same manner as we define vertical boxes with the \vbox and 
\vtop commands. The new boxes differ from the old ones in the manner in 
which they are aligned with their surroundings. Specifically, in the new boxes 
it is the center point of the box that is vertically aligned with the center of the 
text, instead of the baseline of the bottom or top line of the box, respectively, 
aligned with the baseline of the text. 


Example of Source Text l Corresponding Formatted Text 
xxxxx. \def\B#1{\hbox{Box} Box 
\hbox{aligned} aligned 
\hbox{at the}\hbox{#1.}} Box at the 
$\vcenter{\B{center}}$ XXXXX. aligned bottom. Box 
\vbox{\B{bottom}} oe aligned 
\vtop{\B{top}} center: at the 
top. 


Variables and Operations 


TEX offers different commands for processing boxes, and 256 variables 
for storing such entities. 


o \newbox(variable). The variables that record boxes can be referenced 
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directly through their indexes or referenced indirectly through names that 
are assigned to them by the current command. 


\setbox(variable)=(boz). This command records the given box (boz) in 
the specified variable. 


\nt (variable). This command is treated like a variable name that holds 
the height of the box that is stored in (variable). 


Example of Source Text Corresponding Formatted Text 


\newbox\bx 4.30554pt 6.11111pt 
\setbox\bx=\hbox{\tt x} 

\the\ht\bx 

\setbox\bx=\hbox{\tt abc} 

\the\ht \bx 


The pseudovariable ‘\ht(variable)’ gets a new value whenever the variable 
(variable) changes its content. Yet, the user can change the value of the 
pseudovariable to offer a factitious height to the box that is stored in 
(variable). 


Example of Source Text Corresponding Formatted Text 
\newbox\bx XXXXXXXX 
\setbox\bx=\hbox{xxxxxxxx} 

\hbox{xxxxxxxx} XXXXXXXX 


\ht\bx=25pt \box\bx 


\dp(variable). This command is treated like a variable name that holds 
the depth of the box that is stored in (variable). 


\wd(variable). This command is treated like a variable name that holds 
the width of the box that is stored in (variable). 


\box(variable). This command produces the content of a specified box 
variable, and thereafter leaves the variable with empty content (at the 
global scope). 


Example of Source Text Corresponding Formatted Text 
\newbox\bx 15.74986pt, 4.30554pt, 2.22223pt, 
\setbox\bx=\hbox{\tt xyz} xyz, 0.0pt, 0.0pt, 0.0pt, . 


\the\wd\bx, \the\ht\bx, 
\the\dp\bx, \box\bx, 
\the\wd\bx, \the\ht\bx, 
\the\dp\bx, \box\bx. 


The content of the variable is determined when the \setbox command 
assigns a box to the variable, not when the \box command exposes the 
box. 
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o 


[*] 


o 


Example of Source Text Corresponding Formatted Text 


\newcount\c  \newbox\bx 12, 0. 
\setbox\bx=\hbox{y, 

\global\c=12} 
\the\c, \c=0 \box\bx \the\c. 


\copy(variable). This command produces the content of the specified 
variable without modifying the content of the variable. 


Example of Source Text Corresponding Formatted Text 
\newbox\bx abc 
\setbox\bx=\hbox{\tt abc} abc 


\leavevmode \copy\bx 
\raise 10pt\copy\bx 


\unhbox (variable), \unvbox(variable). The \unhbox command produces 
the content of the horizontal box that is stored in the specified variable, 
and thereafter leaves the variable with empty content. 


The \unvbox command is a variant of the \unhbox command that applies 
to vertical boxes. 


\unhcopy(variable), \unvcopy(variable). The Nunhcopy command pro- 
duces the content of the horizontal box that is stored in the specified 
variable without modifying the value of the variable. 


The \unvcopy command is a variant of the \unhcopy command that ap- 
plies to vertical boxes. 


\vsplit(variable) to (dimension). This command produces a vertical 
box that holds the top portion, of vertical size (dimension), of the box 
that is stored in the variable. The box that is stored in the variable is left 
with the other portion of its content. 


Example of Source Text Corresponding Formatted Text 
\newbox\bx " to achieve text 
\setbox\bx= The vertical that is type- 
\vtop{\hsize=0.7in box is split set into two 
The vertical box is into two parts jns. 


split into two parts 
to achieve text that is 
typeset into two 
columns.) 

\leavevmode 

\vsplit\bx to 0.5\dp\bx 

\qquad \box\bx 
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Selectors 


The following commands respectively test positively for variables that 
hold horizontal boxes, for variables that hold vertical boxes, and for variables 
that hold no boxes. 


\ifhbox (variable) 

\ifvbox(variable) 

\ifvoid(variable) 
Example of Source Text Corresponding Formatted Text 
\newbox\bx y 


\setbox\bx=\hbox{x} 
\ifhbox\bx \setbox\bx=\vbox{y} 
\fi  \box\bx 


New Fillers 


TEX views overfilled boxes similarly to the way it views underfilled boxes. 
Specifically, it views underfilled boxes as boxes that have voids of positive 
magnitudes, and it views overfilled boxes as boxes that have voids of negative 
magnitudes. TEX offers the \hss and \vss commands to fill horizontal voids 
and vertical voids, respectively, with spaces that can stretch or shrink to the 
magnitudes of the voids that they encounter. 


Example of Source Text Corresponding Formatted Text 


\hbox to 32pt {aaa\hss auxxbbb 
xxxx\hss bbb} 


The \hss and \vss commands can be used only within boxes, and they 
have the same force as the \hfil and \vfil commands, respectively. 


Example of Source Text Corresponding Formatted Text 
\hbox to 1in{x\hss x\hss x} X x B 
\hbox to iin{x\hss x\hfil x) * x x 
\hbox to 1in{x\hss x\hfill x) XX x 


The Map command carries a definition of the form ‘\def\llap#1{\hbox 
to Oem {\hss #1}}’. Can you determine how \rlap is defined? 


B.2 Marks 


To allow for sophisticated footers and headers (for instance, like the ones used 
in this book), TEX introduces the commands ‘\mark{(token list)}’, \first- 
mark, \botmark, and \topmark. The \mark command records its actual pa- 
rameters. The other commands produce token lists that are recorded by 
\mark. 
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Upon reaching a \mark command, TEX stores the expansion of the token 
list that the command receives. The expansion is made under the same rules 
that apply to the token lists of the \edef and \write commands. 

When TEX starts working on a document, it assigns empty token lists to 
\firstmark, \botmark, and \topmark. When TEX determines the boundaries 
of a page, it assigns to \topmark the token list of \botmark. Then, TEX 
assigns to \firstmark the first token list that has been recorded by \mark 
in the current page, and it assigns to \botmark the last token list that has 
been recorded by \mark in the current page. However, if no \mark command 
appears in the current page, TẸX also gives \firstmark and \botmark the 
token list that it assigned to \topmark. 

The \firstmark, \botmark, and \topmark commands produce the last 
token lists that TgX assigned them. 


Example of Source Text s Corresponding Formatted Text 
\def\x#1{\mark{#1-1} Page 1: ,,. 
\mark{#1-2} Page 2: 1-1, 1-3,. 
\mark{#1-3} \y#1} Page 3: 2-1, 2-3, 1-3. 
\def\y#i{Page #1: \firstmark, Page 4: 3-1, 3-3, 2-3. 
\botmark, \topmark. Page 5: 4-1, 4-3, 3-3. 
\vfil\break} Page 6: 4-3, 4-3, 4-3. 


\x1 \x2 \x3 \x4 \y5 Vy6 


The boundaries of the pages are determined before the processing of the 
footers and headers. This property distinguishes the \firstmark, \botmark, 
and \topmark commands with regard to their usefulness in the design of 
footers and headers for pages. 


Headers and Footers 


The headers and footers of this book are produced with instructions sim- 
ilar to the following ones. 


o The first two instructions specify the general structure for the headers and 
the footers. i 


\footline={\tenrm\hfil \footer \hfil} 
\headline={\tenrm \botmark 
\ifodd\pageno \rightheader \else \leftheader \fi} 


o A default setting is determined for the pages that appear before the first 
chapter. 


\gdef\f ooter{\the\pageno} 
\gdef\leftheader{\hfil} 
\gdef \rightheader{\hfil} 
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o The next instructions belong to the \Chapter command. They ask that 
the leading pages in the chapters will have page numbers in the footers 
and nothing in the headers. For the other pages, the instructions ask that 
the footers will be empty and the headers will contain page numbers and 
chapter titles. 


\xdef\footer{\noexpand \ifnum 
\the\pageno=\pageno \the\pageno \noexpand\fi}% 
\xdef \leftheader{\noexpand \ifnum 
\the\pageno=\pageno \hfil \noexpand \else 
\noexpand\the\pageno\hfil \uppercase{#1}\noexpand\fil% 
\xdef \rightheader{\noexpand \ifnum 
\the\pageno=\pageno \hfil \noexpand \else 
\uppercase{#1}\hfil\noexpand\the\pageno \noexpand\fi}% 
\mark{}% 


The prefixes \noexpand delay the processing of their associated com- 
mands to the time that the contents of \header and \footer get exposed, 
that is, to the time that the boundaries of the pages are determined. 
Therefore, when the headers and footers are produced the constructs 
‘\noexpand\ifnum \the\pageno=\pageno...\noexpand\fi’ have the 
form ‘\ifnum(number of first page in current chapter)=\pageno...\fi’. 


The ‘\mark{}’ command prevents earlier \mark commands from having 
influence within the new chapters. 


o The next construct belongs to the \Section command. It determines the 
headers for even pages that are not leading pages within the chapters. 


\mark{\gdef \noexpand\rightheader{%, 
\the\ChapterCounter.\the\SectionCounter\space\space 
\uppercase{#1}\hfil\noexpand\the\pageno}}/ 


B.3 Breakpoints and Penalties 


TX uses a penalty points system to decide where line breaks and page breaks 
should occur. It looks at penalty points as a commodity, and it inserts line 
breaks and page breaks at locations that charge the least amount of points. 
When we insert the \break command, we tell TEX that it will be charged 
with —10000 penalty points for inserting a breakpoint at the given location. 
When we insert the \nobreak command, we tell TEX that it will be charged 
with 10000 penalty points for inserting a breakpoint at the given location. 
These values of 10000 penalty points are large enough to overshadow any 
other points that TEX assigns under its own algorithm. 


o> 


B.3 BREAKPOINTS AND PENALTIES 


Example of Source “Text ` 


Xcatcode N0711 \tt 
Nthe NOM 
\par\meaning\e ject 
\par\me aning \break 
\par \me aning\nobreak 


The following commands expect to get an integer nu 


the numbers as penalty points. 


o \penalty (penalty points). The co 
of penalty points if a line break (in 
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Corresponding Formatted Text 


10000 

macro:-?Npar \break 
macro:->\penalty -NOM 
macro:->\penalty NOM 


mber, and they treat 


mmand contributes the specified number 
horizontal mode) or & Page break (in 


vertical mode) occurs at the location of the command. 


For TEX, an amount of 50 penalty 
breakpoints (Npenalty50") and to 


points offers a small incentive to insert 
prevent breakpoints (‘\penalty-50’). 


An amount of 100 penalty points offers a medium incentive, and an amount 
of 200 penalty points offers a big incentive. On the other hand, the com- 
mand ‘\penalty-1’ can be viewed as permission to insert a breakpoint, 
without offering any encouragement or discouragement to do so. 


Example of Source Text 


\hnsize=0.5in 
\def\.{\penalty-1} 
Cecececcecce\par 
Cececec\.c\.c\.c\-c¢ 


Corresponding Formatted Text 


Cecececcecce 
Ceececce 
ccce 


Normally, we insert \nfil, \hfill, \Wfil, and \vfill commands to fill 
voids that are created by forced breakpoints. However, these commands 


may cause undesirable spaces when 


they precede \penalty commands that 


do not produce breakpoints. We can safeguard against the occurrence of 
such situations with the: \hfilneg and \vfilneg commands. The new 
commands cancel the effect of the \hfil and \vfil commands, respec- 
tively, if the latter commands are not followed by breakpoints. 


Example of Source Text 


\hsize=0.5in 
\def\.{\hfil\penalty-1 
\hfilneg} 

ceccece\.c\.c\.c\-6¢ 


Words 


Corresponding Formatted Text 


Ceccece 
cecce 


o \hyphenpenalty=(penalty points). This pseudovariable records the num- 
ber of penalty points that should be charged for each line break that occurs 


oy 


m Xm 


A 


LINE DRAWING 


178 
Example of Source Text Corresponding Formatted Text 
\def \game#1{#1\smallskip CHESS j 
\hrule height 0 — d 
pare a a A board game for two players. A 
width 14mm BRIDGE " 
\smallskip} A card game played by four play- : 
\game{CHESS} A board game ed S 


for two players. \medskip 

\game{BRIDGE} A card game 

played by four players. 
The command takes TFX into vertical mode before drawing the lines, if it 
is encountered in horizontal mode. 

o Wrule height (dimension) depth (dimension) width (dimension). 

In horizontal mode, this command introduces a line with the specified 
height, depth, and width. The command is ignored in vertical mode. 


Example of Source Text Corresponding Formatted Text 
\def \exr#1{\noindent 
\vrule height 2mm 
depth Omm width 2mm\ 
$#1=$ \vrule height Omm 
depth 0.1mm width 10mm} 


\exr{5+3}\par \exr{7-2} 


m54+3= 
87—2—-.— —— 


epth, and width of the lines are optional, 


The specifications of the height, d 
hin the \hrule and \vrule commands. 


and they can appear in any order wit 


Example of Source Text Corresponding Formatted Text 


$$\def\.{\vrule height ipt 


width) 40 miles 
\bullet\underbrace{ ou eT 
110 miles 


\overbrace{\ .40pt} 
“{40\ \rm miles} 


\bullet\.70pt} 
_{110\ \rm miles}\bullet$$ 
Without the specifications, the \vrule command inserts a vertical line 
whose height and depth are equal to the height and depth of the line of text. 
Corresponding Formatted Text 


Card Number ince p 


Example of Source Text 


\def\.{\hrulef i11\vrule} 


Card Number 
\.\.\.\. \nrulef i11\hbox{} 


\par$x\atop y$\vrule\ ANNES 
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Similarly, without the specifications, the \nrule command inserts a hor- 
izontal line whose width is equal to the page width. Within a vertical box, 
the line assumes the width of the box. 


Example of Source Text Corresponding Formatted Text 
\hrule Line Drawing Line Drawin 
\hrule Lines in horizontal Lines in horizontal mode. 1: Lines in 


mode. :\vrule: Lines in horizontal mode. — — 1. 


horizontal mode. Mhrule 


With appropriate bookkeeping, drawings of arbitrary shapes can be pro- 
duced. 


Example of Source Text Corresponding Formatted Text 


\def\Ln{\ifdim Nc«Opt 
\let\Ln=\relax 
\else \advance\c by-0.3pt 
\raise \c \hbox{\vrule 
height 0.3pt depth 0.3pt 
width 0.3pt}Y 
Mi Mn) \newdimen\c 
\leavevmode \c=50pt \Ln 


C.2 Spacing 


The \hrule commands do not leave space above and below the lines that 
they draw, and the \vrule commands do not leave space before and after the 
lines that they draw. By inserting the \strut command within the line of 
text that precedes the \hrule command, we can get a little space above the 
line. Similarly, by inserting the \strut command within the line of text that 
succeeds the \hrule command, we can get a little space below the line. 


Example of Source Text Corresponding Formatted Text 
\hrule\strut Line Drawings Line Drawings 

\hrule\strut Lines in Lines in horizontal mode. :: Lines in 
horizontal mode. :\vrule: horizontal mode. 


Lines in horizontal 
mode. \strut\hrule 


The lack of space around the lines drawn is a desirable feature when we 
want to have full control of the distances between the lines that we draw and 
the text that surrounds them. 
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Example of Source Text \hfill \vrule \hfill 


\hsize=50pt \vrule \hrule width 50pt 


\hrule width 50pt \vfil 


\noindent \vrule height 15pt : 
\hfill \vrule \hfill Corresponding Formatted Text 


\vrule \hrule width 50pt 
\vfil 
\noindent \vrule height iSpt 
We can always create spaces of a desired magnitude around the lines that 


\vrule draws with the \nskip command and around the lines that \hrule 
draws with the \vskip command. 


Example of Source Text \xx \vskip2pt 


\def \xx{\vtop{\hsize=43pt \hrule}\vrule 
Xxxxxxx x x.}} 


\noindent\vrule \setbox0=\xx Corresponding Formatted Text 
\vbox{\hsize=\wd0 

\advance\hsize by 4pt Xxx 

\hrule \vskip2pt XXXXX 

\noindent \hskip2pt x. 


C.3 Variants 


A variant of \nrulefill named \dotfill can be used to fill extra spaces 
with dots instead of lines. 


Example of Source Text Corresponding Formatted Text 
Chicago--New York\dotfill 835 Chicago-New York............. 835 
Boston-Seattle................ 3056 


Boston--SeattleMdotfill 3056 


We can also design our own variants of Nhrulefill to fill extra spaces 
with other elements. Specifically, the command ‘\leaders(boz)\hfill’ asks 
TEX to fill the extra space horizontally with as many copies of (boz) as pos- 
sible. 


Example of Source Text Signature WnyfillWMhrulefill 


\hsize=1.5in \parindent=0em \hrulefill\hbox{} 


\def \myfill{\leaders 
\hbox{\tt\char95}\hfill} 
Payment \myfill 
\hbox to 0.5in{\$ Payment _____ —— 
\hrulefill}\par Signature 


Corresponding Formatted Text 
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Similarly, the command ‘\leaders(boz)\vfill’ asks TEX to fill the extra 
space vertically with as many copies of (boz) as possible. 


Example of Source Text Corresponding Formatted Text 
\vtop to 1in{ 
\leaders\hbox to iini 
\leaders\hbox to 
4pt{\hss.\hss} 
\hfill} 
\vfill} 


The \leaders command also works with the \hfil and \vfil com- 
mands. 


Appendix D 


OUTPUT ROUTINES 


The output routines are the ones utilized to submit the pages to the dvi files. 
They are invoked after the text for the pages has been processed, yet they 
still leave some room to determine the entities that should be included in the 
pages and the layout for the entities within the pages. This appendix consists 
of two sections. The first discusses output routines in general, and the second 
demonstrates how can they be used. 


D.1 How They Work 


When TpX determines the boundary of a page, it places the content of the 
page inside box variable number 255 and executes the commands that are 
stored within the \output variable. The commands are executed within an 
implicit group. 


Example of Source Text \x(\output): macro :- 
>{\plainoutput } 

\plainoutput:  macro:- 
>\shipout \vbox {\makeheadline 
\pagebody \makefootline 
}\advancepageno \ifnum 
\outputpenalty >-\@MM \else 
\dosupereject \fi 

\pagebody: macro:->\vbox 
to\vsize {\boxmaxdepth 
\maxdepth \pagecontents } 

\pagecontents: macro:- 


Corresponding Formatted Text >\ifvoid \topins \else \unvbox 
Default output routines of TEX: \topins Mi \dimen@ =\dp 


Default output routines of 
\TeX:\tt\par\string\x(\string 
\output): \edef\x{\the 
\output} \meaning\x 
\par\string \plainoutput: 
\meaning \plainoutput 

\par\string \pagebody: 
\meaning \pagebody 

\par\string \pagecontents: 
\meaning \pagecontents 
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B.3 BREAKPOINTS AND PENALTIES 


Example of Source Text 


Xcatcode N0711 \tt 
\the\OM 
\par\meaning\e} ect 
\par\me aning\break 
\par\meaning\nobreak 


The following com 
the numbers as penalty points. 


o \penalty (penalty points) 
ints if a line break ( 


occurs at the locati 


For Tex, an amount of 50 penalty 


breakpoints (Npenalty50' 
An amount of 100 penalty point 
of 200 penalty point 
mand Npenalty-i can be V 
without offering 2? 


Example of Source Text 


\nsize=0.5in 

\def\ .{\penalty-t} 
cececececcee \pat 
AE sere A 


Normally, we insert 
voids that are create 
may cause undesirable space 
do not produce 
such situations 
commands cance 
tively, if the latter co 


Example of Source Text 


\nsize=9- 5in 
\def\. {hf i1Npene1ty-i 
\nfilnegt 


d 


Words 


o \nyphenpenal ty* 
ber of penalty point 


mands expect to get E 


. The comm 
in horizont 
ion of the command. 


points offers a sma 


s offers a Inedium in 


s offers a big incenti 
iewed as 


y encouragement or 


\hfil, \nfill, N 
d by forced bre 
s when th 


he \nfil an 


mmands are not f 


(penalty points). 
s that should | 


! 
a 
i 
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Corresponding Formatted Text 


10000 

macro:->\par \break 
macró:-»Npenalty -NOM 
macro:->\penalty NOM 


| 


nteger number, and they treat 


and contributes the specified number 


al mode) or a page break (in 


ll incentive to insert 
lt breakpoints (‘\penalty-50’). 
centive, and an amount 


i ther hand, the com- 


‘ve. On the © 
ta preakpoint, 


permission to inser 
do so. 


discouragement to 


Corresponding Formatted Text 


Cececececece 
jCeeccece 
|cccc 


; 
i 


11 commands to fill 
However, these commands 
penalty commands that 
inst the occurrence o 
. The new 


d \vfil commands, respec- 


wfil, and \vfi 


«k points. 


l; followed by breakpoints. 
| Corresponding Formatte 


j  Cececce 
cecce 


i 


This pseudovariable records the num- 


be charged fore 


| 
i 


ach line break that occurs i 


176 


178 


LINE DRAWING 


Corresponding Formatted Text 


CHESS 
A board game for two players. 


Example of Source Text 


\det\gameti{#i\smallskip 
\nrule height Omm 


depth 1.5mm 
width 14mm BRIDGE 
\smallskip} A card game played by four play- 
\game{CHESS} A board game eis: 


for two players. \medskip 
\game{BRIDGE} A card game 
played by four players. 


The command takes TX into vertical mode before 


is encountered in horizontal mode. 


drawing the lines, if it 


o Wrule height (dimension) depth (dimension) width (dimension). 


In horizontal mode, this command introduces a line with the specified 


height, depth, and width. The command is ignored in vertical mode. 


Example of Source Text Corresponding Formatted Text 
\def\exr#1{\noindent 
\vrule height 2mm g7-2=—— 
depth Omm width 2mm\ 
$#i=$ \vrule height Omm 
depth 0.1mm width 10mm} 
\exr{5+3}\par \exr{7-2} 


ations of the height, depth, and width of the lines are optional, 


The specific 
e \hrule and \vrule commands. 


and they can appear in any order within th 


Example of Source Text Corresponding Formatted Text 


$$\def\.{\vrule height ipt 


width) 40 miles 
\bullet \underbracef ec? 
\overbrace{\.40pt} 110 miles 


^(40N \rm miles} 
\bullet\.70pt} 
_{110\ Vrm miles}\bullet$$ 


Without the specifications, the \vrule command inserts a vertical line 
whose height and depth are equal to the height and depth of the line of text. 


Corresponding Formatted Text 
Card Number Cp 1e 
z 


Example of Source Text 


\def\.{\hrulef i11\vrule} 
Card Number 

\.\.\.\. \hrulef illMibox() 
\par$x\atop y$\vrule\.\.\.\.\. 
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\@cclv \unvbox \@cclv \ifvoid \footins \fi MfrOggedbottom 
\footins \else \vskip \skip \kern "Minen \vfil Mi 
\footins \footnoterule \unvbox 


That is, when TeX detects that it has a;processed text (accumulated 
teat) in which a page break should occur, it partitions the text into two parts 
(tezt before breakpoint) and (tezt after breakpoint). Then TpX proceeds to 
manipulate the following material. 


\setbox255=\vbox to \vsize{(tezt before breakpoint)} 
{\the\output} 
(tezt after breakpoint) 


Normally, the output routines are designed to submit the components 
(text before breakpoint) into the dvi files together with headlines, footlines, 
footnotes, and some other material. Yet, the output routines programmed into 
the variable \output are free to ignore the components (tezt before breakpoint) 
or to process the components in other desirable ways. 


Example of Source Text Corresponding Formatted Text 
A fragment of {\bf processed) A fragment of processed text within 
text within box 255. i box 255. A fragment of processed 
{\output={\setbox0= text within box 255. 
\vtop{\unvbox255} Note that we asked for a factitious 
\copy0 \box0} page break. 
\par\break} 


Note that we asked for 
a factitious page break. i 


3 


The following features are of interest for output routines. 


o \shipout(boz). This is a command that empties the given box and sub- 
mits the content to the dvi file. The command does not have to appear 
within the \output variable. | 


o Noutputpenalty. This is a pseudovariable:in which TpX records the 
penalty points at the location of a page break. 


o \deadcycles. This is a pseudovariable that is'set to 0 when the command 
\shipout is executed, and is increased by 1 when the routines of \output 
are executed. : 

o \maxdeadcycles. This is a pseudovariable that tells how far \deadcy- 


cle can be increased before TpX issues an error message and invokes the 
command ‘\shipout \box255’. 


o \output={\unvbox255 \the\outputpenalty}. This output routine re- 
constructs (accumulated tezt) if box 255 holds (tezt before breakpoint). 
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o \break. In vertical mode, this command asks TEX to invoke the output 
routine stored in \output. In the default setting, this amounts to a page 
break, but changing the content of the variable might change the effect 
that the command has. 


o If the text (tezt before breakpoint) to be processed by the output rou- 
tines does not fit into a single \vbox of size \vsize, then TEX breaks 
the text into parts and processes them sequentially within constructs 
of the form ‘\setbox255=\vbox to \vsize{(part of tezt before break- 
point)}{\the\output}’. 

o The \mark command can be employed to collect information for output 
routines. TeX modifies the values of \topmark, \firstmark, and \bot- 
mark each time it sets the content of box variable 255 for submission to 
an output routine. 


o The output routines stored in \output must leave box 255 with empty 
content when they finish their tasks. 


D.2 Text in Two Columns 


The definitions listed in this section introduce a simple environment for setting 
text into two columns. The environment is activated by constructs of the 
form ‘\TwoColumns(tezt)\EndTwoColumns’. The definitions employ the next 
variables. 


\newbox\col \newdimen\xhsize \newtoks\xoutput 
\newbox\colA \newdimen\xvsize 
\newbox\col1B \newdimen\dimA 


\newbox\pagesofar \newdimen\dimB 


The \TwoColumns Command 
The opening command takes the following form. 
\def\TwoColumns{\newmedskip 
\begingroup «4 items marked with ʻo’ pp} 
o Save the dimensions and external output routine needed within the local 
environment. 


\xhsize=\hsize 
\xveize=\vsize 
\xoutput=\output 


o Record in variable \pagesofar the material that TgX accumulated so far 
and has not shipped out yet. 
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These pseudovariables can be employed to determine whether given let- 
ters are uppercase or lowercase letters. 


Example of Source Text Corresponding Formatted Text 
\def\1lc#i{#1: A: uppercase, a: lowercase. 
\ifnum‘#1=\lccode‘#1 
lowercase\else 
uppercase\fi} 


Mc A, Mc a. 


The next commands, and the hyphenation algorithm of TEX, consult the 
pseudovariables 'NIccode(character code)’ and ‘\uccode(character code)’. 


o Mowercaset(token list)). This command replaces each character token 
in (token list) with a new character token. The new character tokens are 
obtained from the old character tokens by replacing the character codes 
(character code) in the old character tokens with the character codes that 
are stored in the pseudovariables *'N1ccode(character code)’. 


No replacement takes effect when a pseudovariable 'N1ccode(character 
code)’ holds a zero value. On the other hand, the new tokens inherit 
the category codes of the old tokens. 


Example of Source Text \def?{+++} 
\tt \1ccode‘\?=*\* \lowercase{X?X}, X?X. 


\lowercase{X?X}, X?X. 
\catcode‘\*=13 \def+#{...} 
\catcode‘\*=11 
\catcode‘\?=13 x*x, X?X. X...X, X+++X. 


Corresponding Formatted Text 


The \lowercase command allows implicit left braces for delimiters, and 
these implicit left braces can be embedded within other constructs. No 
expansion of tokens is performed for a \lowercase command after its left 
delimiter is encountered. 


Example of Source Text Corresponding Formatted Text 


\tt Mecode'N22/N X*xx*xX?X. 
\def\t{\bgroup X?X} 
\lowercase\t X?7X\t\egroup}. 


o Nuppercaset(token list)}. This command replaces character codes within 
character tokens according to the mappings that are defined by the pseu- 
dovariables ‘\uccode( character code)’. 


Example of Source Text Corresponding Formatted Text 


\romannumeral 123, cxxiii, CX XIII. 
\uppercase\expandafter{y, 
\romannumeral 123}. 


Appendix B 
MORE ABOUT TEX 


This appendix consists of three sections, which deal with boxes, with features 
for gathering information in pages, and with breakpoints in lines and pages, 
respectively. 


B.1 Boxes 


Chapter 10 introduced us to the features of boxes, and the end of Sec. 12.3 
introduced us to a few features for inquiring about the dimensions of boxes. 
This section elaborates further on these topics. 


Widths 


The width of a horizontal box is either specified explicitly in the definition 
of the box or determined implicitly by the box’s content when no specification 
is given. 

The width of a vertical box is determined by the width of its content. 
The content can consist of paragraphs and of other boxes that are inserted 
in vertical mode. When a vertical box contains only boxes (all inserted in: 
vertical mode), it assumes the width of the widest of these boxes. 


Example of Source Text Corresponding Formatted Text 
Before--\vbox{ Wider box. 
\hbox{Wider box.} Before-Box. —After. 


\hbox{Box.}}--After. 


The values that the variable \hsize holds do not directly affect the ver- 
tical boxes. These values just determine the widths of the paragraphs, which 
in turn may determine the widths of the boxes. 
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B.1 BOXES 
Example of Source Text Corresponding Formatted Text 
Before--\vbox{\hsize=9in Wider box. 
\hbox{Wider box.} Before—Box. —After. 


\hbox{Box.}}--After. 


Shifted Boxes 


We can raise, lower, shift left, or shift right a box (boz) to a distance 
(dimension) with commands of the following form. 


\raise (dimension) (boz) 
\lower (dimension) (boz) 
\moveleft (dimension) (boz) 


\moveright (dimension) (boz) 


The first pair of commands apply only in horizontal mode, and the last 
two commands apply only in vertical mode. 


Example of Source Text Corresponding Formatted Text 
\noindent \raise 15pt Raised box 
\hbox{Raised box} and and 
\lower 15pt \hbox{lowered 
lowered box. 


box.} 


New Variants 


Within math mode we can also define vertical boxes with the \vcenter 
command, in the same manner as we define vertical boxes with the \vbox and 
\vtop commands. The new boxes differ from the old ones in the manner in 
which they are aligned with their surroundings. Specifically, in the new boxes 
it is the center point of the box that is vertically aligned with the center of the 
text, instead of the baseline of the bottom or top line of the box, respectively, 
aligned with the baseline of the text. 


Example of Source Text Corresponding Formatted Text 
xxxxx. \def\B#1{\hbox{Box} Box 
\hbox{aligned} aligned 
\hboxf{at the}\hbox{#1.}} Box at the 
$\vcenter{\B{center}}$ xxxxx, @ligned bottom. Box 
\vbox{\B{bottom}} at tne aligned 
\vtop{\B{top}} center; at the 
top. 


Variables and Operations 


TEX offers different commands for processing boxes, and 256 variables 
for storing such entities. 


o \newbox(variable). The variables that record boxes can be referenced 
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o 


o 


o 


o 


o 


directly through their indexes or referenced indirectly through names that 
are assigned to them by the current command. 


\setbox(variable)=(boz). This command records the given box (boz) in 
the specified variable. 


Mht(variable). This command is treated like a variable name that holds 
the height of the box that is stored in (variable). 


Example of Source Text Corresponding Formatted Text 


\newbox\bx 4.30554pt 6.11111pt 
\setbox\bx=\hbox{\tt x} 

\the\ht \bx 

\setbox\bx=\hbox{\tt abc} 

\the\ht\bx 


The pseudovariable ‘\ht(variable)’ gets a new value whenever the variable 
(variable) changes its content. Yet, the user can change the value of the 
pseudovariable to offer a factitious height to the box that is stored in 
(variable). 


Example of Source Text Corresponding Formatted Text 
\newbox\bx XXXXXXXX 
\setbox\bx=\hbox{xxxxxxxx} 

\hbox{xxxxxxxx} XXXXXXXX 


\ht\bx=25pt \box\bx 
\dp(variable). This command is treated like a variable name that holds 
the depth of the box that is stored in (variable). 
\wd(variable). This command is treated like a variable name that holds 
the width of the box that is stored in (variable). 


\box(variable). This command produces the content of a specified box 
variable, and thereafter leaves the variable with empty content (at the 
global scope). 


Example of Source Text Corresponding Formatted Text 
\newbox\bx 15.74986pt, 4.30554pt, 2.22223pt, 
\setbox\bx=\hbox{\tt xyz} xyz, 0.0pt, 0.0pt, 0.0pt, . 


\the\wd\bx, \the\ht\bx, 
\the\dp\bx, \box\bx, 
\the\wd\bx, \the\ht\bx, 
\the\dp\bx, \box\bx. 


The content of the variable is determined when the \setbox command 
assigns a box to the variable, not when the \box command exposes the 
box. 
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o 


o 


Example of Source Text Corresponding Formatted Text 


\newcount\c  \newbox\bx 12, 0. 
\setbox\bx=\hbox{% 

\global\c=12} 
\the\c, \c=0 \box\bx \the\c. 


\copy(variable). This command produces the content of the specified 
variable without modifying the content of the variable. 


Example of Source Text Corresponding Formatted Text 
\newbox\bx abc 
\setbox\bx=\hbox{\tt abc} abc 


\leavevmode \copy\bx 
\raise 10pt\copy\bx 


\unhbox(variable), \unvbox(variable). The \unhbox command produces 
the content of the horizontal box that is stored in the specified variable, 
and thereafter leaves the variable with empty content. 


The \unvbox command is a variant of the \unhbox command that applies 
to vertical boxes. 


\unhcopy (variable), \unvcopy(variable). The Nunhcopy command pro- 
duces the content of the horizontal box that is stored in the specified 
variable without modifying the value of the variable. 


The Nunvcopy command is a variant of the \unhcopy command that ap- 
plies to vertical boxes. 


Wsplit(variable) to (dimension). This command produces a vertical 
box that holds the top portion, of vertical size (dimension), of the box 
that is stored in the variable. The box that is stored in the variable is left 
with the other portion of its content. 


Example of Source Text Corresponding Formatted Text 
\newbox\bx : to achieve text 
\setbox\bx= The vertical that is type- 
\vtop{\hsize=0.7in box is split set into two 
The vertical box is into two parts columns. 


split into two parts 
to achieve text that is 
typeset into two 
columns .} 
Mleavevmode 
\vsplit\bx to 0.5\dp\bx 
\qquad \box\bx 
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Selectors 


The following commands respectively test positively for variables that 
hold horizontal boxes, for variables that hold vertical boxes, and for variables 
that hold no boxes. 


Mi fhbox(variable) 

Mifvbox(variable) 

Mi fvoid(variable) 
Example of Source Text Corresponding Formatted Text 
\newbox\bx y 


\setbox\bx=\hbox{x} 
\ifhbox\bx \setbox\bx=\vbox{y} 
Mi  \box\bx 


New Fillers 


TpX views overfilled boxes similarly to the way it views underfilled boxes. 
Specifically, it views underfilled boxes as boxes that have voids of positive 
magnitudes, and it views overfilled boxes as boxes that have voids of negative 
magnitudes. TEX offers the \hss and \vss commands to fill horizontal voids 
and vertical voids, respectively, with spaces that can stretch or shrink to the 
magnitudes of the voids that they encounter. 


Example of Source Text Corresponding Formatted Text 


\hbox to 32pt {aaa\hss auxxbbb 
xxxx\hss bbb} 


The \hss and \vss commands can be used only within boxes, and they 
have the same force as the \hfil and \vfil commands, respectively. 


Example of Source Text Corresponding Formatted Text 
\hbox to 1in{x\hss x\hss x} * x x 
\hbox to 1in{x\hss x\hfil x) * x x 
\hbox to iin{x\hss x\hfill x) ** x 


The \llap command carries a definition of the form ‘\def \Llap#1{\hbox 
to Oem {\hss #1}}’. Can you determine how \rlap is defined? 


B.2 Marks 


To allow for sophisticated footers and headers (for instance, like the ones used 
in this book), TEX introduces the commands ‘\mark{ (token list)}’, \first- 
mark, \botmark, and \topmark. The \mark command records its actual pa- 
rameters. The other commands produce token lists that are recorded by 
\mark. 
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Upon reaching a \mark command, TFX stores the expansion of the token 
list that the command receives. The expansion is made under the same rules 
that apply to the token lists of the \edef and \write commands. 

When TẸX starts working on a document, it assigns empty token lists to 
\firstmark, \botmark, and \topmark. When TFX determines the boundaries 
of a page, it assigns to \topmark the token list of \botmark. Then, TeX 
assigns to \firstmark the first token list that has been recorded by \mark 
in the current page, and it assigns to \botmark the last token list that has 
been recorded by \mark in the current page. However, if no \mark command 
appears in the current page, TEX also gives \firstmark and \botmark the 
token list that it assigned to \topmark. 

The \firstmark, \botmark, and \topmark commands produce the last 
token lists that TEX assigned them. 


Example of Source Text Corresponding Formatted Text 
\def\x#1{\mark{#1-1} Page 1: ,,. 
\mark{#1-2} Page 2: 1-1, 1-3, . 
\mark{#1-3} \y#1} Page 3: 2-1, 2-3, 1-3. 
\def\y#1{Page #1: \firstmark, Page 4: 3-1, 3-3, 2-3. 
\botmark, \topmark. Page 5: 4-1, 4-3, 3-3. 
\vf£il\break} Page 6: 4-3, 4-3, 4-3. 


\x1 \x2 \x3 \x4 \y5 \y6 


The boundaries of the pages are determined before the processing of the 
footers and headers. This property distinguishes the \firstmark, \botmark, 
and \topmark commands with regard to their usefulness in the design of 
footers and headers for pages. 


Headers and Footers 


The headers and footers of this book are produced with instructions sim- 
ilar to the following ones. 


o The first two instructions specify the general structure for the headers and 
the footers. 


\footline={\tenrm\hfil \footer \hfil} 
\headline={\tenrm \botmark 
\ifodd\pageno \rightheader \else \leftheader \fi} 


o A default setting is determined for the pages that appear before the first 
chapter. 


\gdef\footer{\the\pageno} 
\gdef\leftheader{\hfil} 
\gdef \rightheader{\hfil} 
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o The next instructions belong to the \Chapter command. They ask that 
the leading pages in the chapters will have page numbers in the footers 
and nothing in the headers. For the other pages, the instructions ask that 
the footers will be empty and the headers will contain page numbers and 
chapter titles. 


\xdef \footer{\noexpand \ifnum 
\the\pageno=\pageno \the\pageno \noexpand\fi}% 
\xdef \leftheader{\noexpand \ifnum 
\the\pageno=\pageno \hfil \noexpand \else 
\noexpand\the\pageno\hfil \uppercase{#1}\noexpand\fi}% 
\xdef \rightheader{\noexpand \ifnum 
\the\pageno=\pageno \hfil \noexpand \else 
\uppercase{#1}\hfil\noexpand\the\pageno \noexpand\fi}% 
\mark{}% 


The prefixes \noexpand delay the processing of their associated com- 
mands to the time that the contents of \neader and \footer get exposed, 
that is, to the time that the boundaries of the pages are determined. 
Therefore, when the headers and footers are produced the constructs 
‘\noexpand\ifnum \the\pageno=\pageno. .. \noexpand\fi’ have the 
form ‘\ifnum(number of first page in current chapter)=\pageno...\fi’. 


The ‘\mark{}’ command prevents earlier \mark commands from having 
influence within the new chapters. 


The next construct belongs to the \Section command. It determines the 
headers for even pages that are not leading pages within the chapters. 


o 


\mark{\gdef \noexpand\rightheader{/ 
\the\ChapterCounter .\the\SectionCount er\space\space 
\uppercase{#1}\hf 41\noexpand\the\pageno}}% 


B.3 Breakpoints and Penalties 


TX uses a penalty points system to decide where line breaks and. page breaks 
should occur. It looks at penalty points as a commodity, and it inserts line 
breaks and page breaks at locations that charge the least amount of points. 
When we insert the \break command, we tell TEX that it will be charged 
with —10000 penalty points for inserting a breakpoint at the given location. 
When we insert the \nobreak command, we tell TEX that it will be charged 
with 10000 penalty points for inserting a breakpoint at the given location. 
These values of 10000 penalty points are large enough to overshadow any 
other points that TEX assigns under its own algorithm. 
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Example of Source Text Corresponding Formatted Text 
\catcode‘\@=11 \tt 10000 

\the\ OM Macro:->\par \break 
\par\meaning\eject , macro:-»Mpenalty -\@M 
\par\meaning\break l macro:->\penalty NOM 
\par\meaning\nobreak 


The following commands expect to get an integer number, and they treat 
the numbers as penalty points. 


o \penalty (penalty points). The command contributes the specified number 
of penalty points if a line break (in horizontal mode) or a page break (in 
vertical mode) occurs at the location of the command. 


For TEX, an amount of 50 penalty points offers a small incentive to insert 
breakpoints (‘\penalty50’) and to prevent breakpoints (‘\penalty-50’). 
An amount of 100 penalty points offers a medium incentive, and an amount 
of 200 penalty points offers a big incentive. On the other hand, the com- 
mand ‘\penalty-1’ can be viewed as permission to insert a breakpoint, 
without offering any encouragement or discouragement to do so. 


Example of Source Text Corresponding Formatted Text 
\hsize=0.5in Cecccecceccec 
\def\.{\penalty-1} Cecceccc 

CcccccccccccMpar ccce 


Ceccecc\.c\.c\.c\.cc 


Normally, we insert \hfil, Nhfill, \vfil, and Nvfill commands to fill 
voids that are created by forced breakpoints. However, these commands 
may cause undesirable spaces when they precede \penalty commands that 
do not produce breakpoints. We can safeguard against the occurrence of 
such situations with the \hfilneg and \vfilneg commands. The new 
commands cancel the effect of the \hfil and \vfil commands, respec- 
tively, if the latter commands are not followed by breakpoints. 


Example of Source Text Corresponding Formatted Text 
\hsize=0.5in Ceecece 
\def\.{\hfil\penalty-1 cecce 

\hfilneg} 


Ceccccc\.c\.c\.c\.cc . 


Words 


o \hyphenpenalty=(penalty points). This pseudovariable records the num- 
ber of penalty points that should be charged for each line break that occurs 
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within a word. TẸX assumes a default value of 50 penalty points for each 
such line break. 


Example of Source Text Corresponding Formatted Text 

\hsize=66.3pt Hyphenpenalty 

\def\x{Hyphenpenalty within within hyphen- 
hyphenpenalty. \par} penalty. 

\x Myyphenpenalty-10000 Hyphenpenalty 

\x within hyphenpenalty. 


o \exhyphenpenalty=(penalty points). This pseudovariable holds the num- 
ber of penalty points that should be charged for line breaks that occur 
after the hyphen character ‘-’. TEX assumes a default value of 50 penalty 
points for each such line break. 


Pages 


o \clubpenalty=(penalty points). This is the penalty for inserting a page 
break after the first line of a paragraph. 


Appendix C 


LINE DRAWING 


Only a few features for drawing lines are offered by TEX. Yet, these features 
provide all the support that we need within text. The first section of this 
chapter introduces the features, and the second deals with space issues. The 
third section concludes this appendix with a discussion of variants of the above 
features. 


C.1 The Commands 


Forms, titles, and other pieces of text use horizontal and vertical lines to get 
special effects. In TEX, lines can be drawn using the following commands. 


o \hrulefill. This command is a variant of \hfill. It draws horizontal 
lines in the extra spaces that it claims for itself. 


Example of Source Text Corresponding Formatted Text 

Name \hrulefill\hbox{}\par Name 

Address \hrulefill\break Address 

Phone \hrulefill(H) Phone ______(H) _____(O) 
\hrulefill(0) 


The command is not allowed in vertical mode, and it is ignored at the 
ends of paragraphs. 


o \hrule height (dimension) depth (dimension) width (dimension). 
This command introduces a line with the specified height, depth, and 
width. 
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Example of Source Text Corresponding Formatted Text 
\def \game#1{#1\smallskip CHESS 
\hrule height Omm €—€— g 
depth 1.5mm A board game for two players. 
width 14mm BRIDGE 
\smallskip} 
P A card game played by four play- 

\game{CHESS} A board game ers 


for two players. \medskip 

\game{BRIDGE} A card game 

played by four players. 
The command takes TẸX into vertical mode before drawing the lines, if it 
is encountered in horizontal mode. 

o \vrule height (dimension) depth (dimension) width (dimension). 

In horizontal mode, this command introduces a line with the specified 
height, depth, and width. The command is ignored in vertical mode. 


Example of Source Text Corresponding Formatted Text 
\def \exr#1{\noindent HN5-13-. — 
\vrule height 2mm 9my7—2—. —— 


depth Omm width 2mmN 

$#1=$ \vrule height Omm 

depth 0.1mm width 10mm} 
\exr{5+3}\par \exr{7-2} 


The specifications of the height, depth, and width of the lines are optional, 
and they can appear in any order within the \hrule and \vrule commands. 


Example of Source Text Corresponding Formatted Text 
$$\def\.{\vrule height ipt 
width} 40 miles 
\bullet\underbracef ——>e________* 
\overbrace{\ .40pt} 110 miles 


^(40N \rm miles} 
\bullet\.70pt} 
_{110\ \rm miles}\bullet$$ 
Without the specifications, the \vrule command inserts a vertical line 
whose height and depth are equal to the height and depth of the line of text. 


Example of Source Text Corresponding Formatted Text 
\def\.{\hrulefill\vrule} Card Number 1 1 1 i 
Card Number : 


\.\.\.\.\hrulefill\hbox{} 
\par$x\atop y$\vrule\.\.\.\.\. 
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Similarly, without the specifications, the \hrule command inserts a hor- 
izontal line whose width is equal to the page width. Within a vertical box, 
the line assumes the width of the box. 


Example of Source Text Corresponding Formatted Text 


\hrule Line Drawing Line Drawing 
\hrule Lines in horizontal ines in horizontal mode. :: Lines in 
mode. :\vrule: Lines in horizontal mode. 


horizontal mode. Mhrule 


With appropriate bookkeeping, drawings of arbitrary shapes can be pro- 
duced. 


Example of Source Text Corresponding Formatted Text 


\def\Ln{\ifdim Nc«Opt 
\let\Ln=\relax 
\else \advance\c by-0.3pt 
\raise \c \hbox{\vrule 
height 0.3pt depth 0.3pt 
width 0.3pt}y, 
Mi Man] \newdimen\c 
\leavevmode \c=50pt \Ln 


C.2 Spacing 


The \hrule commands do not leave space above and below the lines that 
they draw, and the \vrule commands do not leave space before and after the 
lines that they draw. By inserting the \strut command within the line of 
text that precedes the \nrule command, we can get a little space above the 
line. Similarly, by inserting the \strut command within the line of text that 
succeeds the \hrule command, we can get a little space below the line. 


Example of Source Text — . Corresponding Formatted Text 
\hrule\strut Line Drawings Line Drawings 

\hrule\strut Lines in Lines in horizontal mode. :; Lines in 
horizontal mode. :\vrule: horizontal mode. 


Lines in horizontal 
mode. \strut\hrule 


The lack of space around the lines drawn is a desirable feature when we 
want to have full control of the distances between the lines that we draw and 
the text that surrounds them. 
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Example of Source Text \hfill \vrule \hfill 
\hsize=50pt \vrule \hrule width 50pt 


\hrule width 50pt \vfil 


\noindent \vrule height 15pt 
\hfill \vrule \hfill Corresponding Formatted Text 


\vrule \hrule width 50pt 
\vfil 
\noindent \vrule height 15pt 


We can always create spaces of a desired magnitude around the lines that 
\vrule draws with the \hskip command and around the lines that \hrule 
draws with the \vskip command. 


Example of Source Text \xx \vskip2pt 


\def \xx{\vtop{\hsize=43pt \hrule}\vrule 
Xxxxxxx x x.) 


\noindent\vrule \setbox0=\xx Corresponding Formatted Text 
\vbox{\hsize=\wd0 

\advance\hsize by 4pt Xxx 

\hrule \vskip2pt XXXXX 

\noindent \hskip2pt x. 


C.3 Variants 


A variant of \hrulefill named \dotfill can be used to fill extra spaces 
with dots instead of lines. 


Example of Source Text Corresponding Formatted Text 
Chicago--New York\dotfill 835 Chicago-New York........ sse. 835 
Boston-Seattle................ 3056 


Boston--Seattle\dotfill 3056 


We can also design our own variants of \hrulefill to fill extra spaces 
with other elements. Specifically, the command ‘\leaders(boz)\hfill’ asks 
TEX to fill the extra space horizontally with as many copies of (boz) as pos- 
sible. 


Example of Source Text Signature\myfill\hrulefill 


\hsize=1.5in \parindent=0em \hrulefill\hbox{} 


\def\myfill{\leaders 
\hbox{\tt\char95}\hfill} 
Payment \myfill 
\hbox to 0.5in{\$ Payment _____ $ 
\hrulefill}\par Signature________ 


Corresponding Formatted Text 
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Similarly, the command ‘\leaders(boz)\vfill’ asks TpX to fill the extra 
space vertically with as many copies of (boz) as possible. 


Example of Source Text Corresponding Formatted Text 


\vtop to iini 
\leaders\hbox to iini 
\leaders\hbox to 
4pt{\hss.\hss} 
\hfill} 
\vfill} 


The \leaders command also works with the \hfil and \vfil com- 
mands. 


Appendix D 


OUTPUT ROUTINES 


The output routines are the ones utilized to submit the pages to the dvi files. 
They are invoked after the text for the pages has been processed, yet they 
still leave some room to determine the entities that should be included in the 
pages and the layout for the entities within the pages. This appendix consists 
of two sections. The first discusses output routines in general, and the second 
demonstrates how can they be used. 


D.1 How They Work 


When TX determines the boundary of a page, it places the content of the 
page inside box variable number 255 and executes the commands that are 
stored within the \output variable. The commands are executed within an 
implicit group. 


Example of Source Text \x(\output) : macro :- 
>{\plainoutput } 

\plainoutput: | macro:- 
>\shipout \vbox {\makeheadline 
\pagebody \makefootline 
}\advancepageno \ifnum 
\outputpenalty >-\@MM \else 
\dosupereject \fi 

\pagebody: macro:->\vbox 
to\vsize {\boxmaxdepth 
\maxdepth \pagecontents } 

\pagecontents: macro:- 
>\ifvoid \topins \else \unvbox 


Default output routines of 
\TeX:\tt\par\string\x (\string 
\output): \edef\x{\the 
\output} \meaning\x 
\par\string \plainoutput: 
\meaning \plainoutput 

\par\string \pagebody: 
\meaning \pagebody 

\par\string \pagecontents: 
\meaning \pagecontents 


Corresponding Formatted Text 
Default output routines of TEX: \topins \fi \dimen@ =\dp 
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\@cclv \unvbox \@cclv \ifvoid \footins \fi \ifrggedbottom 
\footins \else \vskip \skip \kern -\dimen@ \vfil \fi 
\footins \footnoterule \unvbox 


That is, when TpX detects that it has a processed text (accumulated 
tezt) in which a page break should occur, it partitions the text into two parts 
(tezt before breakpoint) and (tezt after breakpoint). Then TFX proceeds to 
manipulate the following material. 


\setbox255=\vbox to \vsize{(tezt before breakpoint)} 
{\the\output} 
(text after breakpoint) 


Normally, the output routines are designed to submit the components 
(tezt before breakpoint) into the dvi files together with headlines, footlines, 
footnotes, and some other material. Yet, the output routines programmed into 
the variable \output are free to ignore the components (tezt before breakpoint) 
or to process the components in other desirable ways. 


Example of Source Text Corresponding Formatted Text 
A fragment of {\bf processed} A fragment of processed text within 
text within box 255. l box 255. A fragment of processed 
{\output={\setbox0= text within box 255. 
\vtop{\unvbox255} Note that we asked for a factitious 
\copy0 \box0} page break. 
\par\break} 


Note that we asked for 
a factitious page break. 


The following features are of interest for output routines. 


o \shipout(boz). This is a command that empties the given box and sub- 
mits the content to the dvi file. The command does not have to appear 
within the \output variable. 


o \outputpenalty. This is a pseudovariable in which TEX records the 
penalty points at the location of a page break. 


o \deadcycles. This is a pseudovariable that is set to 0 when the command 
\shipout is executed, and is increased by 1 when the routines of \output 
are executed. 


o \maxdeadcycles. This is a pseudovariable that tells how far \deadcy- 
cle can be increased before TeX issues an error message and invokes the 
command ‘\shipout\box255’. 


9 \output={\unvbox255 \the\outputpenalty}. This output routine re- 
constructs (accumulated tezt) if box 255 holds (tezt before breakpoint). 
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o \break. In vertical mode, this command asks TEX to invoke the output 
routine stored in \output. In the default setting, this amounts to a page 
break, but changing the content of the variable might change the effect 
that the command has. 


o If the text (tezt before breakpoint) to be processed by the output rou- 
tines does not fit into a single \vbox of size \vsize, then TpX breaks 
the text into parts and processes them sequentially within constructs 
of the form ‘\setbox255=\vbox to WMsizei(part of text before break- 
point)}{\the\output}’. 

o The \mark command can be employed to collect information for output 
routines. TEX modifies the values of \topmark, \firstmark, and \bot- 
mark each time it sets the content of box variable 255 for submission to 
an output routine. 

o The output routines stored in \output must leave box 255 with empty 
content when they finish their tasks. 


D.2 Text in Two Columns 


The definitions listed in this section introduce a simple environment for setting 
text into two columns. The environment is activated by constructs of the 
form ‘\TwoColumns(tezt)\EndTwoColumns’. The definitions employ the next 
variables. 


\newbox\col \newdimen\xhsize \newtoks\xoutput 
\newbox\colA \newdimen\xvsize 
\newbox\co1B \newdimen\dimA 


\newbox\pagesofar \newdimen\dimB 


The \TwoColumns Command 
The opening command takes the following form. 
\def\TwoColumns{\newmedskip 


\begingroup << items marked with ‘o’ pp} 


o Save the dimensions and external output routine needed within the local 
environment. 
\xhsize=\hsize 


\xvsize=\vsize 
\xoutput=\output 


o Record in variable \pagesofar the material that TeX accumulated so far 
and has not shipped out yet. 
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\output={% 
\global\setbox\pagesofar=\vbox{y, 
\unvbox\pagesofar 
\unvbox255}}% 
\break 


The \break command is executed in vertical mode, triggering TEX to call 
the output routine stored in \output. When the output routine is called, 
box 255 holds within a \vbox of height \vsize all the material that has 
been accumulated. If the accumulated material does not fit into a single 
\vbox of this size, TEX transfers the material in pieces through a sequence 
of calls to the routine. 


Recall that the \unvbox and \vbox commands leave their boxes with 
empty content. 


o Submit to the dvi file the pages that can be filled with material which 
precedes the two-column environment. 


\ShipFilledPages 


The job is performed in the next recursive macro, defined outside of 
\TwoColumns. 


MdefNShipFilledPages 
\dimB=\ht \pagesofar 
\advance\dimB by \dp\pagesofar 
\ifdim \dimB>\xvsize 
\begingroup 
\vbadness = 10000 
\global\setbox255=\vsplit\pagesofar to \xvsize 
\wd255=\hsize 
\endgroup 
\the\xoutput 
\else \let\ShipFilledPages=\relax 
Mi \ShipFilledPages} 


TEX tries its best to split boxes with Nvsplit to specified dimensions, but 
it might meet constraints that exclude the possibility of achieving good 
outcomes. The ‘\vbadness=10000’ command inhibits messages warning 
about bad outcomes. 


If figures and footnotes are allowed within the pages, the dimensions of 
the boxes \topins and \footins holding these entities should also be 
considered in the calculations of \dimB. 


o Specify for a box generated by the \vsplit command, the minimum dis- 
tance between the top boundary and the baseline of the top line in the 
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box, and the maximum depth for the last line in the box. The assigned 
dimensions are similar to the ones that apply for the top and last lines in 


a page. 
\splittopskip=\topskip \splitmaxdepth=\maxdepth 


o 


Set an output routine for future page breaks encountered within the two- 
column environment before reaching \EndTwoColumns. The output routine 
places the text accumulated for a given page in variable \col, calls the 
command \SubmitPage to send the page, and receives the leftover text. 


\advance\hsize by -0.04\hsize 
\divide\hsize by 2 \vsize=2\vsize 
\output = {\setbox\col=\box255 
\SubmitPage 
\unvbox\col \penalty\outputpenalty} 


The Command \SubmitPage 


The command \SubmitPage receives a column of material stored in \col, 
splitting it into three parts: two parts for the columns in the page to be sent 
out, and a third part which is the leftover material. 


\def\SubmitPage{{<< items marked with ‘e’ pp}} 


e Find the height of the void left in the current page, where material in two 
columns can be inserted. 


\dimB=\xvsize 
\advance\dimB by -\ht\pagesofar 
\advance\dimB by -\dp\pagesofar 


e Get the two columns of material for the current page. 


\ifdim \dimB>Opt \begingroup 
\vbadness = 10000 
\global\setbox\colA=\vsplit\col to \dimB 
\global\setbox\colB=\vsplit\col to \dimB 
\wd\colA=\hsize \wd\colB=\hsize 
\endgroup \fi 


A nonpositive value in \dimB indicates a full page with no space for addi- 
tional text in two columns. 
e Put together the content of the current page. 


\setbox255=\vbox to \xvsize{\unvbox\pagesofar 
\ifdim \dimB>0pt 


D.2 TEXT IN TWO COLUMNS 187 


\hbox to \xhsize{% 
\box\colA\hfil\box\colB}% 
Mid 


e Submit the current page to the dvi file under the external conditions that 
apply for the single column environment. 


\hsize=\xhsize \vsize=\xvsize \the\xoutput 


The \EndTwoColumns Command 


The closing of the environment sets the remaining material into two 
columns, stores in box \pagesofar the material accumulated so far for the 
current page, then exits into the surrounding environment where it unveils 
the content of box \pagesofar. 


\def\EndTwoColumns{\par 
44 items marked with 'o? pp 
\endgroup 
\unvbox\pagesofar 
\medskip } 


© Typeset the remainder of the text, under the current conditions into one 
narrow column, then store it in \col. TẸX calls the output routine re- 
cursively, starting with empty content in \col, and transferring in each 
iteration a \vbox of dimension \vsize stored in box variable 255. 


\output={\global\setbox\col=\vbox{\unvbox\col 
\unvbox255}}% 

\break 

© Find the space needed for setting the column within pages. 
\dimA=\ht\col \advance\dimA by\dp\col 
\divide\dimA by 2 

© Determine the amount of space left in the current page. 
\dimB = \xvsize 
\advance\dimB by -\ht\pagesofar 
\advance\dimB by -\dp\pagesofar 

© Submit as many pages as can be filled with existing material. 
\ShipFullPages 


The next recursive macro, which is defined outside of \EndTwoColumns, 
takes care of the bookkeeping involved in submitting the pages. 
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\def\ShipFullPages{%, 

\ifdim \dimA>\dimB 
\SubmitPage 
\dimB=\xvsize 
\dimA=\ht\col \advance\dimA by\dp\col 
\divide\dima by 2 

\else 
\let\ShipFullPages=\relax 

\fi \ShipFullPages} 


o Insert the leftover text, if any, into \colA and \co1B. 


\ifdim \dimA>Opt 

\advance\dimA by 0.5001\baselineskip 

\begingroup 
\vbadness = 10000 
\global\setbox\colA=\vsplit\col to\dimA 
\global\setbox\colB=\box\col 
\wd\colA=\hsize \wd\colB=\hsize 

\endgroup 

\fi 


The command ‘\advance\dimAby 0.5001\baselineskip’ takes care of 
text with odd number of lines, eliminating the possibility of having an 
extra widow that does not fit into any column. 


o Arrange together the material collected so far for the current page. 


\ifdim \dimA >Opt 
\global\setbox\pagesofar=\vbox{% 
\unvbox\pagesofar 
\hbox to \xhsize{\vtop{\unvbox\colA}\hfil 
\vtop{\unvbox\colB}}}% 
\fi 


The boxes stored in variables \colA and Nco1B, holding the two-column 
material, have vertical dimensions \dimA which might not be their natural 
dimensions. At the bottom of a page, we want to keep the boxes in such 
dimensions, stretching and shrinking the vertical spaces to justify their 
bottom lines along the bottom of the page. On the other hand, at the end 
the environment, we do not care about such justifications. 


Leaving the material within the boxes of \colA and \co1B, using the \box 
command, causes the spaces to stretch and shrink to conform with the 
dimensions of the boxes. Moving the material from the boxes into vertical 
boxes of unspecified dimensions, using the \unvbox command, provides 
for columns with natural dimensions. 


Appendix E 


MATHEMATICAL 
TABLES 


The three sections that make up this appendix introduce commands for con- 
structing mathematical tables. The commands in the first two sections deal 
with tables that have two columns, and the commands in the third section 
deal with tables that have an arbitrary number of columns. 

The different commands must appear in math mode. They all assume 
that the control sequence \cr signals where the rows end, and that the tab 
character ‘&’ identifies the boundaries between the entities in the rows. 


E.1 Systems of Equations 


The following equation alignment command creates a table with two columns. 
The entries in the left column are flushed rightward, and the entries in the 
right column are flushed leftward. The width of a column is determined by 
the widest entry in the column. 


\eqalign{ 
(left-hand side;)&(right-hand side; )Ncr 
(left-hand side3)&(right-hand sideo)\cr 


PURIS die ew A eU ou EO E DU LOS J 
Example of Source Text Corresponding Formatted Text 
$$\eqalign{ z? + y? < 25 
x^2*y^2 & < 25 \cr 2 2 
x°2+y"2 & > 9 \cr z +y >9 
y & \leq 0\cr}$$ y<0 
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Each row in a table is considered to be an equation that has a left-hand 
side and a right-hand side. Each side of an equation is typeset in math mode. 
The alignment character ‘&’ can be omitted from equations that have empty 
right-hand sides. 


Example of Source Text Corresponding Formatted Text 
\def\.{\cdot} $\eqalign{512 512 = 2-256 ...— 27.2 
&= 2\.256 \cr &= 2^2N.128 \cr c 8 
&- 2^3V.64 \cr = f ve x 

&- 2°4\.32 \cr }$\hfill = 2" - 64 

$\eqalign{\cdots &= 2^7N.2 \cr = 95.32 


&= 2^8 \cr \cr \cr#$ 


The command \eqalign typesets its content into a vertically centered 
box. Fillers have no effect on the location of the entries. 


Labels 


In display math mode, the two commands Veqno and \leqno produce 
labels for formulas in general and for math tables in particular. Specifically, 
the commands consider the entities that succeeds them to be labels for the 
formulas that precede them. The \eqno command flushes the labels toward 
the right margin and the \leqno command flushes the labels toward the left 
margin. 


Example of Source Text Corresponding Formatted Text 

$$ a+b=b+a \eqno (1)$$ The 
label (1) Es on a formula, duc dS (1) 
and the label ($\cal E$) The label (1) is on a formula, and 
is on a math table. the label (£) is on a math table. 

$$ Neqaligni 
ab £ -ba Ncr ab — ba 
a(btc) & =abtac \cr} E: a(b + c) = ab + ac 


\leqno \cal E: $$ 


Two variants of the \eqalign command, \eqalignno and \leqalignno, 
allow similar labels for specific equations in such a table. In these variants, 
each row may hold up to two tab characters, ‘&’. The first '&' in a row identifies 
the boundary between the two parts of an equation, and the second identifies 
the label. Within a row in \eqalignno, a second ‘&’ is equivalent to an \eqno, 
and within a row in \leqalignno, a second ‘&’ is equivalent to a \leqno. 


Example of Source Text Corresponding Formatted Text 


$$\eqalignnof z?” = (a^)? 
x*{2n} &= (x^n)^2Ncr 


&>0 &\forall x>0\cr}$$ >0 Ve > 0 
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Embedded Text 


The command ‘\noalign{ (token list)?! can be used to insert intermediate 
pieces of text between equations. TFX enters vertical mode before inserting 
the text, and it typesets the text in an ordinary manner. 


Nesting 


Each entry in a table may hold any math formula. And in fact a formula 
by itself may be a table. 


Example of Source Text Corresponding Formatted Text 
$Negaligni 142=3 - 
\eqalign{1+2%=3\cr 5-2= 
15+6&%=21\cr} 15+6=21 
& Nqquad 5-2-3 \cr}$ 


E.2 Conditional Equations 


In appearance the following command is similar to Veqalign, but its outcome 
is somewhat different. Specifically, the command places a left brace on the 
table, typesets the entries in the left column in math mode, and typesets the 
entries in the right column in ordinary mode. 


\cases{ 
(formula part,)&(tezt part,)\cr 
(formula part;)&(tezt part;)Ncr 


gvios ia sra lee nee teas aT RIO ACE } 
Example of Source Text Corresponding Formatted Text 
$f (x)=\cases{ -2—2 ifzc-2 
-x- 2 & if $x<-2$\cr f(z) | —2 if z > 2 
x- 2 & if $x> 2$\cr —z? +4 otherwise 


-x^2*4 & otherwise\cr}$ 


We can shift the entries horizontally within the columns, we can change 
the fonts within the entries, and we can offer other modifications. 


Example of Source Text Corresponding Formatted Text 
$|x|=\cases{ lel = ee z«0 
-x & $x<0$\cr z otherwise 


\hfill x & otherwise\cr}$ 


In the default form, each entry is placed between a pair of \hfil com- 
mands, within a horizontal box whose width is equal to the width of the 
column. 
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E.3 Matrices 


Math tables with multiple columns can be produced with the following com- 
mand. 


\matrix{ 
(formula,1)&(formula,2)& --- &(formula;m)\cr 
(formulag,)&(formulaz2)& --- &(formulazm)\cr 
ARET aah toed MERA «accel vod NES eralenersalacdnce boone } 
Example of Source Text Corresponding Formatted Text 
$$\matrix{1&2%3&4\cr 1 2 3 4 
10£20&30£40Ncr 10 20 30 40 
100&200&%300&400\cr}$$ 100 200 300 400 


Each formula is placed into a horizontal box that has the width of the 
column, with \hfil commands placed around the formula to get it centered 
within the box. We can use standard filling commands to shift the formulas 
horizontally within their columns. 


Example of Source Text Corresponding Formatted Text 
$\matrix{ a b+c+d e 
a\hfill& btctd & \hfill e\cr a+b c d+e 
atb &c & d+e\cr}$ 


The \matrix command typesets its content into a vertically centered 
box, and it allows ordinary pieces of text to be inserted with the \noalign 
command. 


Example of Source Text Corresponding Formatted Text 
$ A=\left[\matrix{ a11 ^'^ Qim 
a_{1\,1} &\cdots &a_{1\,m}\cr — 4 . 

\vdots & &\vdots \cr 


a_{n\,1} &\cdots &a_{n\,m}\cr As) hee ee 


\noalign{\vskip 2pt} }\right]$ 


Entries may hold any math formula, including tables. The command 
‘\pmatrix{...}? is offered as a shorthand way of writing the construct ‘\left ( 
\matrix{...}\right)’. 


Example of Source Text Corresponding Formatted Text 
$$ \pmatrix{ 1 2 
\pmatrix{1&2\cr3%4\cr}&a\cr 3 4 


&\pmatrix{1&2\cr3z4\cr}\cr }$$ (; z) 
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ORDINARY TABLES 


We can define commands of our own to produce ordinary tables, or we can“ 
use the TEX commands described in this appendix for this purpose. The 

commands in the first section of this appendix set the columns to widths 

specified by the users, whereas the commands in the second section determine 

the widths of the columns from their contents and typeset the entries in the 

columns according to templates that the users specify. The third section 

considers line drawings in tables, and the concluding section shows how tables 

can be shifted horizontally and vertically. 


F.1 Through Tabs 


A \settabs command is offered for defining the formats of tables through 
imaginary tabs. To insert a row into a table, the user needs to identify the 
start of the row with the ‘\+’ command, identify the boundaries between the 
entries with the tab command ‘&’, and identify the end of the row with the 
\cr command. 


By Division 
Tables that are made up of m equal-size columns can be produced in the 


following manner. 


\settabs m Ncolumns 
Ve (tezti1)&(tezt15)& --- &(teztim)\cr 
\+(tezta1)&(teate2)& --- &(teztam)\cr 


The space characters that succeed the ‘\+’, *&', and \cr commands are 


ignored by TgX. 
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Example of Source Text 


ORDINARY TABLES 


Corresponding Formatted Text 


\settabs 4 \columns {\bf North East South West 

\+North&East&South&West\cr} Pass Pass 19 19 

\+Pass& Pass& 1 \tensy\char 1N.T. Pass Pass Pass 
125& 1 \tensy\chari26\cr 

\+1 N.T.£ Pass& Pass& Pass\cr 


Empty entries are allowed in the tables, and the tab commands ‘&’ are 
not needed for empty entries that appear at the end of a row. 


Example of Source Text Corresponding Formatted Text 


\settabs 4 \columns {\bf North East South West 
\+NorthgEast&South&West\cr} 19 19 
\+&& 1\tensy\char125& 1\tensy 1N.T. 

\char126\cr \+1 N.T.\cr 


The ‘\+...\cr’ construct inserts an independent line of text, in accor- 
dance with the tab settings that exist when the construct is encountered. A 
table is obtained when a sequence of such constructs appears with no interrup- 
tions. However, if we so desire, we can insert arbitrary pieces of text between 


the constructs. 
Example of Source Text Corresponding Formatted Text 


\settabs 5\columns If we add the integer values 


If we add the integer 1 2 3 
values \+&1&2&%3\cr to the to the integer values 
integer values \+&4&5&6\cr 4 5 6 

we get the following we get the following values. 


values. \+&5&7&9\cr 5 7 9 


A setting of tabs with \settabs holds until it is replaced with a new 
setting. Settings that are made within groups have effect only within the 
groups. 


By Example 


The command \settabs can use a sample row to determine the widths of 
the columns instead of using an argument of the form ‘m \columns’ for such 
a purpose. With a sample row, the command allocates to each column the 
width that is required by the text that the sample row has for that column. 


\settabs 

\+(tezto1)&(teztor)& +++ &(teztom)\cr % sample 
\+(text11)&(tezti2)& --+ &(teztim)\cr 
\+(tezta1)&(tezt22)& --+ &(teztam)Ncr 
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Example of Source Text Corresponding Formatted Text 
\settabs \+Moon\quad Rise Set 

&0:00 xm\quad £0:00 xm\cr Sun 6:02 a.m. 8:20 p.m. 
ME Rise£ Set\cr Moon 7:30 a.m. 6:41 p.m. 


\tSun& 6:02 a.m.& 8:20 p.m.\cr 
\+Moon&7:30 a.m.& 6:41 p.m.\cr 


TEX does not really care how much text is placed in each entry. It does not 
even complain when a piece of text that is too wide for its column spreads into 
succeeding columns. Allit cares about is where the columns start. Therefore, 
we do not have to specify the last entries (teztom) in the sample rows. 


Example of Source Text Corresponding Formatted Text 
\settabs \+X\quad& I 1 C 100 

XX\qquad& X\quad&\cr V 5 D 500 
\+1&1&C&100\cr X 10 M 1000 
\+V&5&D&500\cr L 50 


\+X&10&M&1000\cr \+Le50\cr 


Fine Tuning 


We can allocate more entries than we need with \settabs, then ignore 
the extra entries within the ‘\+...\cr’ constructs. This approach produces 
narrower tables. 


Example of Source Text Corresponding Formatted Text 
\settabs 5 \columns sine cosine 

\+ &sine&cosine\cr 0 0 1 

\+ 0& Ok i\cr 90 1 0 

\+90& 1& O\cr 


We can shift tables around the pages by putting them into boxes and then 
shifting the boxes around. In doing so, we should notice that the dimensions 
of the boxes are determined by the tables that they contain, and that the 
width of a table is equal to the width of its longest row. 


Example of Source Text Corresponding Formatted Text 
$$\vcenter{% sine cosine 
\settabs 5 \columns 0 0 1 

\+ &sine&cosine\cr 90 1 0 

\+ 0& 0& 1\cr 

\+90& ik O\cr}$$ 


We can shift horizontally within the columns any entry that is not the 
last one in its row. 
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Example of Source Text Corresponding Formatted Text 
\let\.=\hfil sine cosine 
\settabs 5 \columns 0 0 1 
\t+\.&\.sine&\.cosine&\cr 90 1 0 

\+\.0& \.0& \.1&\cr 

\t\.90& \.1& \.0\cer 


The ‘\+...\cr’ construct generates a line of text in which each entry 
is inserted into a horizontal box. The last entry (tezt) in the construct is 
inserted into a box of the form ‘\hbox{(tezt)}’, no matter whether the entry 
is in the last column of the table or not. The other entries are inserted into 
boxes of the form ‘\hbox to (dimension) {(tezt)\hss}’, where (dimension) 
denotes the width that \settabs assigned to the corresponding column. 


Example of Source Text Corresponding Formatted Text 

\let\.=\hfil sine cosine 

\settabs \+XX&\quad&xxxxxx& 0 0 1 
\quad&xxxxxx&\cr 90 1 0 


\+\. &&\.sine&g&\.cosine&\cr 
\t\.0&& \.0&& \.1&\cr 
\t\.90&& \.1&& \.0\cr 


F.2 Through Templates 


Instead of specifying the widths of the columns in a table with the \settabs 
command, we can employ the following horizontal alignment command to 
supply templates for the entries in the columns. 


\halign{ 

(texto, 1#terto,1)& (texto, 2t#tezto,2)& -++ &(tezto,m#teztosm) \cr 
(field ,,)&(fieldi;)& +++ &(field,,,)\cr 

(field (fields) --- &(field,,,)\ex 


eost] i] |] |] |] n] |] |] |]| |] | | | |] | | À | À n 


Example of Source Text Corresponding Formatted Text 
\halign{# ££ &# &#\cr 12 3 4 

i&2&3&4Ncr 5&6&%7&8\cr 56 7 8 

9&10811%12\cr} 9 10 11 12 


The entries in the jth column are typeset according to the jth template 
(tezto,;#tezto,;). The template specifies the content of the entries, with the 
character ‘#’ denoting where the fields (field;;) should be inserted. 
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Example of Source Text Corresponding Formatted Text 
\halign{# dollars& 1.25 dollars 125 cents 
\qquad#& # cents\cr 5.75 dollars 575 cents 
1.25&&i25Ncr §.75&&575\cr 3.05 dollars 305 cents 


3.05%&%305\cr} 


Spaces Within Entries 


The width of each column is determined by the widest entry in the col- 
umn. Within entries that do not reach the widths of their columns, the spaces 
are stretched to fill the voids (without issuing 'Underfull \hbox...’ warning 
messages). 


Example of Source Text Corresponding Formatted Text 
\halign{#&\qquad#&#\cr VOLUME 
& VOLUME\cr 6 eggs 1.3 liq cups 
6 eggs& 1.3 liq cups\cr cold water 2 tbl spn 
cold water& 2 tbl spn\cr salt 1 tbl spn 
salt& 1 tbl spn\cr unsifted flour 5 cups 


unsifted flour£ 5 cups\cr} 


The \halign command inserts each entry into a horizontal box that has 
the width of the corresponding column and that does not complain about 
overfilled and underfilled situations. We can shift entries within their boxes 
with standard filling commands. 


Example of Source Text Corresponding Formatted Text 


\halign{\hfil#a$x+{#}$u Tx + 43y = 107 
\hfil#e$y={#}$e#\cr llz+ y=35 
7T&&43&&107Ncr 112&%&35\cr} 


Nesting 


The \halign commands are not allowed to contain other \halign com- 
mands directly, but indirect containments through boxes are possible. 


Example of Source Text Corresponding Formatted Text 
\halign{#&\quad#2\quad#\cr Game-I Game-II 
&Game-I &Game-II\cr Player-A 12 123 
Player-A 34 | 456 
& \vtop{\halign{# &iNcr 56 
i&2Ncr 3&4Ncr 5&6\cr}} Player-B 1002 SCORES 
& \vtop{\halign{# &# &iNcr 3 400 


1&2&%3\cr 4&5£6Ncr))NCr 
Player-B & \vtop{\halign{# & 
#\cr 100&2\cr 3&%400\cr}} 
& $\bf NO\atop\bf SCORES$\cr} 
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Repeated Templates 


We can insert an extra tab character ‘&’ before one of the templates. 
When this extra tab character is present, TEX will back up to the template 
that follows the extra tab character when it runs out of templates. 


Example of Source Text Corresponding Formatted Text 

\halign{a.# &&b.# &c.# Ncr a.l b.2¢.3 b.4c.5 b.6 
1&2&3&42526\cr a.@ b.* c.Q b.* c.@ b.* c.O b.* c. 
O&*LOL*LOK*EOR*E\ Cr} 


An extra tab character in essence defines a list of infinitely many tem- 
plates. The feature of an extra tab character is particularly useful when we 
want to get uniform columns. 


Example of Source Text Corresponding Formatted Text 
\newcount\c 1 2 3 4 5 
\def\.{\global\advance\c by 1 6 7 8 9 10 

\hfill \the\c} 11 12 13 14 15 
\halign{&\.#\quad\cr 16 17 18 


&&Ek&Ncr &&&&Ncr 
&£&&&Ncr &&Ncr) 


Combined Entries 


We can use the following commands to insert text between rows and to 
combine successive entries in the rows. 


o \noalign{(token list)). This command can appear between rows to in- 
troduce ordinary fragments of text between the rows. 


Example of Source Text Corresponding Formatted Text 
\halign{\qquad$#$\quad& z y  f(z,y) 

$#$\quad& $#$\cr f(z,y)=a+y 
x& y& £(x,y)\cr 1 2 3 
\noalign{\noindent 7 11 18 

$f (x,y)=xt+y$} f(z,y)=2-y 

182&3\cr 7%11%18\cr 24 7 17 
\noalign{\noindent 231 121 110 


$f (x,y)=x-y$} 
24&7&i7Ncr 231&121&110Ncr) 


o \omit. If this command is encountered at the start of a field (field ;;), then 
the field itself is inserted into the entry and the corresponding template 
(tezto,;#tezto,;) is ignored. 
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Example of Source Text 


\halign{$\bullet$#\quad& 
\$\hfil#\quad& 
\$\hfil#$~{99}$\quade 
\$#\cr 

\omit& \omit Reg.& \omit 

Sale& \omit 
Clear.\cr 
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Video& 361% 289% 167\cr 
TV& 1398& 1119£ 646\cr} 


Corresponding Formatted Text 


Reg. Sale Clear. 
eVideo $ 361 $ 289°° $167 
eTV $1398 $1119°° $646 


o \span. This command can be used instead of the tab character ‘&’ to 
separate fields in rows. The command combines its neighboring entries 


into a single entry. 
Example of Source Text 


\halign{#\qquad& \$# each\cr 
\omit\span\omit\hfil 
Shipping Charges\hfil\cr 
1--10£1.30Ncrii--100&1.00Ncr 
111--&0.70\cr} 


Corresponding Formatted Text 
Shipping Charges 


1-10 $1.30 each 
11-100 $1.00 each 
111- $0.70 each 


When two or more entries are combined with the \span command, their 
corresponding templates are also merged. 


Example of Source Text 


\halign{# mi/h & # hours & 
# miles\cr \hfil\it 
v\span$\times$ t\span= d\cr 

120&\quad 2&Nquad 240\cr 

110&\quad 3&\quad 330\cr} 


Corresponding Formatted Text 


v mi/h x t hours = d miles 
120 mi/h 2hours 240 miles 
110 mi/h 3 hours 330 miles 


o \multispan{(integer)}. This command combines (integer) consecutive 
entries of a row into a single entry. The combined entry ignores the tem- 
plates of its components. The braces are optional in the command when 


(integer) has just one digit. 
Example of Source Text 


\def\.#1{\dotfill#1\dotfill1} 

\halign{#:00 &&#\cr 

\omit&Mo £Tu &We &Th &Fr \cr 

8& \multispan5\.{Alg}\cr 

9& \multispan3\.{Sci}$| $e 
\multispan2\.{Eng}\cr} 


Corresponding Formatted Text 
Mo Tu We Th Fr 


8:00 ....... Alg....... 


9:00 ...Sci...|. 


The ‘\multispan{(integer)}’ command is equivalent to a sequence ‘\omit 
\span\omit ---\span\omit’ that consists of (integer) copies of the \omit 
command and (integer) — 1 copies of the \span command. 


200 ORDINARY TABLES 


Spaces around Rows and Columns 


The next commands can control the spaces within the tables that are 
produced with the \nalign commands. 


o \openup(dimension). This command changes the distance between con- 
secutive rows by the specified amount of (dimension). 


Example of Source Text Corresponding Formatted Text 
\openupi0pt \halignf 2 times 
$2^ (it) $Nquad& 9332 5...9 4 
$\overbrace{2\cdots 2}°{#\ 
š 3 time 
\rm times}$\quad& #\cr i pie aie 
2&2&4Ncr 3&3&8\cr } 2 2...2 8 


o \tabskip=(glue). This command inserts the specified amount of flexible 
space before the first column, between consecutive columns, and after the 
last column. l 


Example of Source Text Corresponding Formatted Text 
\tabskip=15pt AREAS OF RECTANGLE 
\halign{&\hfil#\hfil\cr Length Width Area 
\multispan3\hfil AREAS 10 10 100 
OF RECTANGLE\hfil\cr 5 17 85 


Length& Width& Area\cr 
10£ 10£ 100\cr 5£ 17& 85\cr} 


We can also use the \tabskip command within the templates to obtain 
nonuniform spaces around the columns. The amount of space that pre- 
cedes the first column is determined by the value that Ntabskip holds 
when the ‘\halign{...}’ command is encountered. The amounts of space 
between the columns are determined by the values that \tabskip holds 
when the corresponding tab characters ‘&’ are reached. And the amount of 
space that succeeds the last column is determined by the value that \tab- 
skip holds when the \cr that delimits the trailing template is reached. 


Example of Source Text Corresponding Formatted Text 
\tabskip=10pt AREAS OF RECTANGLES 
\halign{\tabskip=20pt Length Width Area 
\hfil#\hfil& \hfil#\hfil& 10 10 100 
\hfil#\hfil\tabskip=0pt\cr 5 17 85 
\multispan3\hfil AREAS OF 
RECTANGLES\hfil\cr 


Length& Width& Area\cr 
10£ 10& 100\cr 5£ 17& 85\cr} 


When we combine entries with the \span command, we get combined 
entries whose natural widths are determined by the widths of the columns 
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that hold the entries that we combine and by the spaces that \tabskip 
introduces between these columns. 

If the natural width is not sufficient for a text that has to be inserted into 
a combined entry, then extra space is inserted between the columns that 
hold the last two entries that are being combined. We can redistribute 
this extra space by increasing the spacing between the columns with the 
\tabskip command. 


Example of Source Text Corresponding Formatted Text 
\halign{&\hfil#\hfil\cr AREAS OF RECTANGLES 
\nultispan3\hfil AREAS Length Width Area 

OF RECTANGLES\hfil\cr 10 10 100 
Length& Width& Area\cr 5 17 85 


10£ 10& 100\cr 5& 17& 85\cr} 


In its default form, \tabskip holds the value Opt, and so the command 
does not introduce any space around the columns. 


o \halign to(dimension){...}. This command is a variant of the Nhalign 
command that specifies the widths of tables. To allow for proper spacing 
around the columns, we should set sufficient flexible space with \tabskip. 


Example of Source Text Length& Width& Area\cr 


\halign to 1.8in{ 10& 10& 100\cr 5& 17& 85\cr} 


\tabskip=20pt plus iin 


\hfil#\hfilk Corresponding Formatted Text 
\hfil#\hfil& 
\hfil#\hfil AREAS OF RECTANGLES 
\t abskip=0pt\cr Length Width Area 
\multispan3\hfil AREAS OF 10 10 100 
RECTANGLES\hfil\cr 5 17 85 


o \hidewidth. This command can appear at the start of an entry, at the 
end of an entry, or at both ends of an entry. The command asks that the 
widths of the specified entries not be taken into account when the widths 
of the columns are determined. 


Example of Source Text \hidewidth Area\hidewidth\cr 
\halign{\tabskip=35pt 10% 10& 100Ncr 5& 17& 85\cr} 
\hfil#\hfil&\hfil#\hfil& 
\hfil#\hfil\tabskip=0pt\cr 


: : Corresponding Formatted Text 
\multispan3\hfil AREAS 


OF RECTANGLES\hfil\cr AREAS OF RECTANGLES 
\hidewidth Length Width Area 
Length\hidewidth& 10 10 100 


\hidewidth Width\hidewidthz 5 17 85 


202 ORDINARY TABLES 


The \hidewidth command is similar to the \hss command. The extra text 
in an entry that holds the command overlaps with the text that precedes 
the entry if the command appears at the start of the entry. The extra text 
overlaps with the text that succeeds the entry if the command appears at 
the end of the entry. And the extra text overflows on both sides of the 
entry to even distances if the command appears at both ends. 


Example of Source Text WidthMhidewidth£ 
\hidewidth Area\hidewidth\cr 


\tabskip=11pt 
10£ 10& 100\cr 5& 17% 85\cr} 


\halign{\tabskip=35pt 
\hfil#\hfil&\hfil#\hfil& 
\hfil#\hfil\tabskip=0pt 


. : Corresponding Formatted Text 
\cr\multispan3\hfil AREAS 


OF RECTANGLES\hfil\cr AREAS OF RECTANGLES 
\hidewidth Length Width Area 
Length\hidewidth& 10 10 100 
\hidewidth 5 17 85 


F.3 With Lines 


Lines are quite often found in tables, and in TeX we can use standard drawing 
facilities to produce such lines. To insert horizontal lines between rows of a 
table, we can use the \hrule command within \noalign commands. 


Example of Source Text 5.36& 5.71\cr 
\halign{\tabskip=20pt \noalign{\hrule}} 
#&#e#\tabskip=O0pt\cr 


& M.M.&C.D.\cr Corresponding Formatted Text 
\noalign{\hrule} Boston& 


\noalign{\hrule} New York& 
To insert vertical lines between the columns, we can use the \vrule 
command within the entries. 


Example of Source Text &Hanna££89&£86gNcr 
\halign{&\vrule#&#\cr \noalign{\hrule}} 
\noalign{\hrule} 
&\multispan5Scores&\cr 


\noalign{\hrule} Corresponding Formatted Text 


&Name&&Game i&&Game 2&\cr Name (ame tame 
\noalign{\hrule} an 


&Dan&£80£&£90gNcr Hannago .—— !8G — 1| 
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The \noalign command expects elements that can appear in vertical 
mode. Therefore, we cannot insert the \vrule command into the \noalign 
commands. Similarly, the entries in the tables expect elements that can appear 
in horizontal mode. Consequently, we cannot use the \hrule command within 
the entries. 


Spacing 
We can use the following pair of commands to improve the appearance 


of the lines drawn within the tables. 


o \strut. This command ensures proper vertical spaces around the hori- 
zontal lines if it is inserted in the rows that bound the lines. 


Example of Source Text Corresponding Formatted Text 
\halign{\tabskip=20pt M.M. C.D. 
\strut Boston 5.50 5.81 
#&#e#\tabskip=Opt\cr New York 5.36 5.71 
& M.M.&C.D.\cr ..... H nig Cd 


o \offinterlineskip. This command asks for tight vertical spaces around 
the rows. Tight vertical spaces around the rows ensure that the vertical 
lines in the different rows will touch one another. 


Example of Source Text Corresponding Formatted Text 


{\offinterlineskip 

\halign{&\strut\vrule# 
&#\cr 

\noalign{\hrule} ..... }} 


Lines highlight the entries within a table and the logic of the table’s 
organization. However, they also highlight careless choices of space around 
the columns. 


Example of Source Text Corresponding Formatted Text 
{\offinterlineskip 
\tabskip=5pt Game 1 
\halign{\strut Dan 80 90 
\tabskip=5pt 89 
\vrule#a#e 
\vrule#&#e 
\vrule#Z#& 
\vrule#\tabskip=0pt\cr 
\noalign{\hrule} ..... }} 


That is, tables with lines require extra attention in general, and in the 
way we handle the spaces with \tabskip in particular. 
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Example of Source Text 


{\offinterlineskip 
\tabskip=0pt 
\halign{\strut 
\tabskip=5pt 
\vrule#a#e 
\vrule#&#e 
Wruledt&it& 
\vrule#\tabskip=0pt\cr 
\noalign{\hrule} ..... }} 


ORDINARY TABLES 


Corresponding Formatted Text 


(Ses O 
[Name [Game 1 | Game 2 | 


Dan 80 90 
Hanna | 89 86 


More succinct representations of tables can sometimes be offered by re- 
placing the multiple constructs ‘\noalign{\hrule}’ within the \halign com- 
mands with a single construct ‘\everycr={\noalign{\hrule}}’ before the 


commands. 


F.4 Shifting 


Tables can be shifted horizontally and vertically by inserting them into vertical 
boxes and shifting the boxes to the desired locations. 


Example of Source Text 


\noindent\hfil\vbox{% 
\offinterlineskip 
\tabskip=0pt 

\halign{\tabskip=5pt 
\vrule#\strut% 
#\strut\hfil& 
\vrule#\strut% 
\hfil#\strut\hfilg 
\vrule#\strut& 
\hfil#\strut\hfil& 
\vrule#\strut& 
\hfil#\strut\hfilg 
\vrule#\strut 
\tabskip=0pt\cr 

\multispan2 &\multispan7%/ 

\hrulefill\cr 

\multispan2 &&\multispan3/ 


\hfil Bytes\hfil && 
Time&\cr 
\multispan2 & \multispan 
5\hrulefill&\omit&\omit 
\vrule\cr 
\multispan2 && I&& 
II&£& in sec.&\cr 
\noalign{\hrule} 
&A&&64,607&£& 489,625£& 272&Ncr 
&B&& -- £&92,628&£ 9&Ncr 
\noalign{\hrule}} } 


Corresponding Formatted Text 


Bytes Time 
II in sec. 
A | 64,607 | 489,625 | 272 


Appendix G 


CATALOG OF 
COMMANDS 


This appendix lists, by topics, different TEX commands, some of which are in- 
troduced here for the first time. Some commands are given with explanations, 
some are conveyed through examples, and some are presented naked. 


G.1 Math Symbols 


Lowercase Greek Symbols 


\alpha...... a \theta...... 0 c E \tau........ T 
\beta....... B \vartheta.. ð \pi criticus T \upsilon... v 
\gamma...... Y \iota....... L \varpi...... u \phi........ $ 
\delta...... 6 \kappa...... K \rho........ p \varphi e 
\epsilon ... € \lambda .... À \varrho .... @ Nchi........ X 
\varepsilon € \mU wo. eee eee m \sigma...... c Mpsi........ y 
Mzeta....... ¢ \n wi. eee eee v \varsigma.. ç \omega...... w 
\eta........ n 


\Gamma...... r \Lambda A \Sigma...... X \Psi........ y 
\Delta...... A AS GET = \Upsilon ...T \Omega...... Q 
\Theta...... 9 NPA oss II \Phi........ $ 

Dots 

Mddots..... “+. \edotp..... * \edots..... +++ Ncolon......... : 
\vdots . Mdotp..... Mdots..... 
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Binary Operations 


esc] n 
secco 
re | 
sec]! o 
er in 
ecco 
ecccc]]] |||] || |á | 
ecc stsaoncco 


M een > 
AY beers < 
Mgeq eene > 
\leq......0. < 
\doteq...... = 
\ne, \neq...# 


x  \oplus..... 

- — Nominus ... 
* — Votimes ... 
* — \oslash ... 
o \odot...... 
e \bigcirc.. 
+  \bigoplus. 
+ \bigotimes 
+ \bigodot.. 

\succ....... 


- 
\prec......- E 
\succeq ....> 
\preceq .... < 
\smile < 


\frown 


nr 
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ecc» 


DD 


IPIE 


\diamond ......... o 
\triangleleft ... < 
\triangleright .. > 


\bigtriangleup.. A 
\bigtriangledown WV 
\wr 


The \not command negates the relation that succeeds the command. 


Example of Source Text 


If $x\not=y$ then 
either $x\not<y$ 


or $x\not>y$. 


Sets 

\cup .....eeee U 
\cap......ee. n 
\uplus....... W 
\sqcap......- n 
\sqcup....... U 
\setminus... \ 
\emptyset... O 


Logic Symbols 


\equiv........eeee 


\bigcup 
\bigcap 
\bigsqcup... 
\biguplus... 
\in 


secct|]| 5| 


w um r-oc 


\forall 
\exists 
\neg, \lnot 
\iff 


— Q  WMagger.......... [1 
Geste s Q  \ddagger......... f 
ie Sia wish © 
\approx Ri Mpropto ....&« 
\sim........ ~ \bowtie ....b4 
\simeq...... ~ \perp....... l 
Ncong....... = \mid......... | 
\asymp...... = Mparallel.. || 
Corresponding Formatted Text 
If z Æ y then either z £ y or z 7 y. 
\subseteq... C \smallint... | 
\subset ..... C \oint........ $ 
\supseteq... D \int......... li 
\supset ..... > \amalg....... II 
\sqsubseteq. C \prod........ Il 
\sqsupseteq. I \coprod..... I 
\SUM MORD X 
Spo eu V — Wigvee ...........Y 
ausi ds jJ  Weigwedge......... A 
zat. = \vee,\lor......... V 
ieee <> \wedge,\land...... A 
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Arrows 
NS86afrOWillcisseeg c even EUR N \NWALTOW woe cece cece cece eee eee N 
NSWATTOR 2. cece cece eee eee Y \mearrow 2... cece cece eee eens VA 
Meftarrow,Mgets............ c— \rightarrow,\to............. — 
MLeftarrow...... esee < Mightarrow.......... eese > 
\longleftarrow ............. — \longrightarrow............ — 
\Longleftarrow ............. = \Longrightarrow............ = 
\leftharpoonup .............. — Meftrightarrow............. = 
\leftharpoondown............ — \Leftrightarrow............. e 
\rightharpoonup............. S \longleftrightarrow ...... ~ 
\rightharpoondown........... — \Longleftrightarrow ...... = 
\rightleftharpoons.......... = \MapSto wo... cece eee e ree HB 
\hookleftarrow .............. > \longmapsto.............ee0e — 
\hookrightarrow ............i — 
Function Names 
\arccos \cosh \det \inf \limsup \min \sinh 
\arcsin \cot \dim \ker Mn \Pr \sup 
\arctan \coth \exp Mg Mog \sec \tan 
\arg \esc \ged Mim \max \sin \tanh 
\cos \deg \hom \liminf 
Miscellaneous Symbols 
Mibar......... h Ntop......;... T \prime......... ! Nclubsuit.... d 
DS E s £ \bot.......... L \surd......... 4 \diamondsuit. > 
NWD oi galore ate f \nabla........ V: \flativ cence. cs b \heartsuit...9 
\partial ..... ð \triangle....A \natural...... h \spadesuit...@ 
Rose i edes. R \angle........ Z \sharp......... ] \aleph........ N 
NIM cet chee’ S \infty....... oo 
Delimiters 
M, Mbrace ....... 1 Mfloor .......... L \uparrow ......... T 
\},\rbrace....... } \rfloor .......... | \Uparrow ......... ft 
Mangle ........... ( NMlceil. Mss [ \downarrow....... l 
\rangle ........... ) \rceil............ ] \Downarrow....... 4 
\backslash....... \ Mbrack ........... [ \updownarrow..... J 
\wert .......eeeeeee | \rbrack ........... ] \Updownarrow..... t 
XVert.ii i ses ll . 

o Meft \right 


Prefixes that enlarge delimiters to sizes that depend on the enclosed text. 
The prefixes must be paired, and as a side effect they also act as delimiters 


for groups. 


208 CATALOG OF COMMANDS 


o \bigl \Bigl \biggl \Biggl 
Prefixes that enlarge left delimiters. 

o \bigr \Bigr \biggr \Biggr 
Prefixes that enlarge right delimiters. 

o \bigm \Bigm \biggm \Biggm 


Prefixes that enlarge delimiters and convert them into binary operations 
(with respect to the amount of space that is placed around the symbols). 


$\bigl\{A\bigm|A \subseteq\{1,2,3\}\bigr\}$ .. {A | AC {1,2,3}} 
o \big \Big \bigg \Bigg 


Prefixes that enlarge delimiters and convert them into standard symbols. 


Templates 
a Dou A sae Seoul's a? \sqrt{atb} ...........-05. Jva+b 
bias Bri eee eee rae dus ap \root ntm\of{atb}.... "ta +b 
a\bmod btc........... amodb+c atb\atop ctd........ eee eee ats 
a\pmod{b+c}...... a (mod b +c) atb\over c*d....... eee eens ott 
a+b 
atb\above imm ctd.......... -— atb\choose ctd............ Cy 
e 
b 
a\atopwithdelims[] b....... [t at+b\brace ctd ......... {eta 
a\overwithdelims[] b....... Hi atb\brack c*d ........ssss [er] 
a\abovewithdelims[]imm b... i" \buildrel * \over{ = }...... = 


o The constructs ‘\root...\of’ and ‘\buildrel...\over’ are treated as 
groups. 


o The constructs ‘[]’ can be replaced by other pairs of delimiters. 


G.2 Text Symbols 


Pf r0 0 fo NB. $ NS .......- $ \copyright. © 
£3 asec hostels MS. CER Jo NI d des sins } NVaa, MA ....ÀÀ 
fl lcaed$we es ff o AE E S E AA L \ae,\ME...œ,Æ 
Ffi eiis fi Nees &' NOS head cies ø \oe,\OE.. ce, CE 
ffl... —H ^ XP.ocens Q. NO zesssesues Q \dots..... € 
Tub eiea eka - \it\$....... £o NBB a oves B \dag........ i 
a — \it\&....... & \silash...... / \ddag.....-- 1 


G.4 FONTS 209 


G.3 Accents 


In Text Mode (\command{o} or \t{oo}) 


NS ahs leans ó No eitia ò bur ô Nd cse o hy gn ó 

Viren ò NA oeesleds [2 NBG 220K o Nt. eos 60 M eese. ó 

NIU eus, ö Nau dad o XC rs Q Nu scs ó 

In Math Mode (\command{o}) 

\acute...... ó \check...... 6 \grave...... ò \tilde...... õ 

\bar........ o Mot ........ ò WMiat« cues ô \vec........ o 

\breve...... ó. \ddot....... ö 

Adjustable Accents for Math Mode (\command{xxx}) 

\overline......... zee Noverleftarrow ...$z4$ \overbrace....... TIT 

\underline........ zzz Noverrightarrow..z242 \underbrace...... zzz 

\widehat .......... £22 \widetilde........ tre 
o M Mj 


Dotless substitutes ‘1’ and ‘y’ for ‘i’ and ‘j’, respectively, to be used with 
accents in text mode. 


o \imath \jmath 
Variants of \i and \j for math mode. 
o \accent (character code) 


This command specifies the code of a character that should be treated as 
an accent for the character that follows. 


\accent‘|U \accent‘*V {\teni\accent45\rm /}.............. v 
G.4 Fonts 
\rm roman..............64. roman $\mit math italic$... mathitalic 
\bf boldface........... boldface $\cal CALLIGRA$ .... CALLIGRA 
Nt 3talic.. ose wes italic $\displaystyle\sum a$..... yr 
\sl slanted............... slanted $\textstyle\sum a$ MP net, Ya 
\tt typewrite ........ typewrite $\scriptstyle\sum a$....... Ya 
\oldstyle 0123456....... 0123456 $\scriptscriptstyle\sum a$ Ye 
Ntenrm... o ccr e vs ABCxyz Nenbf. ilie ee esas ABCxyz 
Xsevenrm .....eeeeeeeessn nn ABCxyz \sevenbf ........... ess ABCxyz 
\fiverm Cr ey ABCxys \fivebf Cr ee ABCxys 


Loading Fonts 


o Mont (internal font name)s(ezternal font name) 
'This loads the specified font. 
\font\itt=cmitti0\itt italic typewriter..... italic typewriter 
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o 


o 


o 


o 
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Mont (internal font name)=(ezternal font name) scaled 
\magstep(magnification step) 


This loads a magnified version of the specified font, if such a version exists. 
The component \magstep(magnification step) can come with a magnifica- 
tion step of 0, 1, 2, 3, 4, or 5, or it can be replaced with \magstephalf. 
The last option gives a magnification step of /1.2. 


\font\sctt=cmtcsci0 scaled \magstep2 
\sctt small capital tt ........ SMALL CAPITAL TT 


Mont (internal font name)=(ezternal font name) at (dimension) 


This loads the specified font magnified to the given dimension, if such a 
version exists for the font. 


\font\sltt=cmsltt10 at 14pt 
\sltt slanted typewriter ...... slanted typewriter 


Mont (internal font name)=(ezternal font name) 
scaled (magnification factor) 


This loads the specified font magnified by the factor of (magnification 
factor) divided by 1000, if such a version exists for the font. 


\font\bfit=cmbxti10 scaled 1440 ] i 
\sltt boldface italic ........... boldface italic 


\fontname\font 
\expandafter\string\the\fontname 


These constructs respectively produce the external and internal names of 
the active font. 


External Font Names 


b-demi b-demiita b-lig b-ligita b-ligobl 
c-bol c-bolobl c-med c-obl emb10 
cmbx10 cmbxsl10 cmbzti10 CcMCcsc10 emdunh10 
cmitt10 cmmiio cmmibio cmr10 cmsl10 
cmsltti0 cmss10 cmssbx10 cmssdc10 cmssi10 
CHTCSC10 cmtex10 emtilO cmtt10 cmul10 
cmvtt10 h-bol h-bolobl h-med h-obl 
nes-bol ncs-bolita ncs-ita ncs-obl ncs-rom 
p-bol p-bolita p-bolobl p-ita p-obl 
p-rom P-ROMSC t-bol t-bolita t-bolobl 
t-ita t-itaun t-obl t-rom T-ROMSC 


zc-medita 


G.5 


DIMENSIONS 211 


G.5 Dimensions 


U 


nit Systems 


bp big point 72bp = 1in 

cc cicero 1cc — 12.84pt 

cm centimeter 1cm = 28.45pt 

dd didót point 1157dd — 1238pt 

em ' 1em = about the width of ‘m’ 
ex 1ex = about the height of ‘x’ 
in inch lin = 72.27pt 

\jot variable name 1\jot = 3pt (initially) 

mm millimeter imm = 2.85pt 

mu math unit 18mu = 1em 

pe pica ipc = 12pt 

pt point 72.2Tpt = 1in 

sp scaled point 65536sp = ipt 

fil flexible with low precedence 

fill flexible with intermediate precedence 


fi 


111 flexible with high precedence 


Pages 


o 


o 


o 


\hsize=(dimension) 

This specifies the width of paragraphs. 
\vsize=(dimension) 
\pagegoal=(dimenston) 


The length of future pages is specified in \vsize. For a current page, the 
length is determined by the value that is stored in \pagegoal. The latter 
variable is initialized to the value of \vsize at the start of each page, and 
the user can change the value of the variable within any page. 


\hoffset=(dimension) 
\voffset=(dimension) 


These specify the rightward and downward offsets for the pages, respec- 
tively. 


\topskip=(glue) 
\maxdepth= (dimension) 


These specify the minimum distance between the top boundary of a page 
and the baseline of the top line in the page, and the maximum depth for 
the last line in the page. 
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o \magnification=\magstep(magnification step) 
This command magnifies the whole content of the document by the factor 
of 1.2 to the power of (magnification step) if it is inserted at the beginning 
of the source document. The values 0, 1, 2, 3, 4, and 5 are legal for 
(magnification step). 
A prefix true to the names of the unit systems protects the mentioned 
dimensions from magnification (for instance, ‘\hskip 2truein’). 


\pagetotal Mpagedepth \pageshrink \pagestretch 


o 


\pagefilstretch \pagefillstretch \pagefilllstretch 


TgX carries in a \vbox the completed entities that have already been ac- 
cumulated for the current page. In the first two pseudovariables it records 
the total natural height and depth of the box. In the other pseudovari- 
ables it records the amount of shrinkable space, stretchable space of type 
fil, stretchable space of type fill, and stretchable space of type £1111, 
respectively, in the box. 


Paragraphs 


o Meftskip-(glue) 

\rightskip=(glue) 

These adjust inward the left margin and the right margin, respectively. 
o \parskip=(glue) 


This specifies the amount of extra glue to be inserted between the para- 
graphs. 


o \parindent=(dimension) 


This specifies the size of indentations at the start of the paragraphs. 


G.6 Spaces 


\negthinspace ... | \thinspace....... I \enskip ......... E 
NU e pex he run s hi \quad........... bod \qquad........ | 


o \hskip(glue) 

\vskip(glue) 

These insert the glue if the command is not encountered at a breakpoint. 
o \hglue (glue) 

\vglue (glue) 


These insert the glue even if the command is encountered at a breakpoint. 
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o \smallskip \medskip \bigskip 


These produce vertical spaces with the magnitudes that are respectively 
specified in the glue variables \smallskipamount, \medskip- 
amount, and \bigskipamount. 


o \kern(dimension) 


This inserts horizontal space in horizontal mode and vertical space in ver- 
tical mode. 


o \enspace \tt\meaning\enspace estes macro:->\kern .5em 
o \lastskip 
This variable holds the size of the space in the last contributed token. 


Between Lines 


o \baselineskip=(glue) 
\lineskip=(glue) 
\lineskiplimit=(dimension) 


The variable \baselineskip determines the vertical distance between the 
baselines of ordinary consecutive lines, that is; between lines that satisfy 
the following relation. 


depth of 
top line 


height of 


+ Mineskiplimit + oi om line 


< \baselineskip 


The variable \lineskip determines the vertical distance between the lines 
(not the baselines) for deep and tall lines that do not satisfy the above 
relation. 


o \openup( dimension) 


This macro increases the distances between the lines by the specified dis- 
tance. (The implementation of the macro increases the values of \base- 
lineskip, \lineskip, and \lineskiplimit by the specified distance.) 


o \normalbaselines 


This macro asks for normal distances between the lines. (The macro 
has the implementation ‘\lineskip=\normallineskip \baselineskip= 
\normalbaselineskip \lineskiplimit=\normallineskiplimit’.) 


o \nointerlineskip 
This instructs TeX not to insert glue after the current line. 
o \offinterlineskip 


This instructs TFX to stop inserting glue between the lines. 
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For Formulas 


o \thinmuskip=(glue in math units) 
\medmuskip=(glue in math units) 
\thickmuskip=(glue in math units) 


These variables determine the amount of glue that the commands ‘\!’, 
‘\,’, ‘\>’, and ‘\;’ insert, respectively. 


\nkern(dimension in mu) 


o 


\mskip(glue in math units) 


\abovedisplayshortskip=(glue) 


o 


\belowdisplayshortskip=(glue) 
\abovedisplayskip=(glue) 
\belowdisplayskip=(glue) 


These specify the amounts of vertical glue to be inserted around displayed 
formulas. The amounts depend on whether or not the lines that precede 
the formulas are short. 


o \displayindent=(dimension) 


This specifies the size of indentations for the displayed formulas. 


Example of Source Text Corresponding Formatted Text 
$$\displayindent=0in n 

Ngun, 1^n i$$ yi 
$$\displayindent=-0.5in 1 

\sum_i*n i$$ n 


o \displaywidth=(dimension) 


This specifies the maximum width of displayed formulas for which TpX 
does not complain about horizontal boxes that are overfilled. 


Space Characters 


o \ignorespaces 


This instructs TEX to ignore the space tokens until a nonexpandable token 
that is not a space token is encountered. 
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o 


o 


o 


o 


Example of Source Text Corresponding Formatted Text 
\def\x#1{\ignorespaces} Ab. A b. 
\def\y#1{} A\x{} b. A\y{} b. 
\obeyspaces 
Example of Source Text Corresponding Formatted Text 


\obeyspaces All the space Allthe space characters within 
characters within the the paragraphs are significant. 
paragraphs are significant. 


\frenchspacing 

This instructs TpX to treat all the spaces between the words in a uniform 
manner, without influence from the punctuation marks. 
\nonfrenchspacing 

This instructs TgX to consider the punctuation marks when introducing 
spaces between the words. 

\spaceskip=(glue) 

\xspaceskip=(glue) 

When the variables \spaceskip and \xspaceskip hold glues of magni- 
tudes different from zero, the spaces between the words do not get their 
normal dimensions. Instead, the dimensions of the spaces that do not fol- 
low the punctuation marks are determined by \spaceskip, and the dimen- 
sions of the spaces that do follow the punctuation marks are determined 
by \xspaceskip. 


Example of Source Text Corresponding Formatted Text 
\def\x{Well. Can you see Well. Can you see the difference? 
the difference? Hopefully. 
Hopefully.) Xx \par Well. Can you see the difference? 
\spaceskip -3pt plusipt Hopefully. 


\xspaceskip=5pt plus6pt \x 
\spacefactor=(integer) 
\sfcode(character code)=(integer) 


The pseudovariables ‘\sfcode(character code)’ hold integer values, called 
space factors, that affect the amount of space that should follow the words 
that end with the different characters. 


Example of Source Text Corresponding Formatted Text 
‘a’: \the\sfcode‘\a, ‘a’: 1000, *)*: 0, ‘,’: 1250, ‘.’: 3000. 
*)?: \the\sfcode‘\), 


,?: \the\sfcode‘\,, 
*,?: \the\sfcode‘\.. 
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Whenever TFX processes a character token that has character code (char- 
acter code), it assigns the value of the pseudovariable ‘\sfcode(character 
code)’ to the pseudovariable \spacefactor. Whenever TpX encounters 
an interword space, it adjusts the amount of stretching and shrinking 
that is allowed for the space in accordance to the value that is stored 
in \spacefactor. The users can change the values of \spacefactor to 
achieve special outcomes on local bases. 


Corrections 


o V 


This command inserts a small amount of space whose size depends on the 
symbol that precedes the command. The extra space that the command 
inserts after a given symbol is called the italic correction of the symbol. 
The main application of the command is in the transition from leaning 
fonts to vertical fonts. 


(Mt f} t, (Nt EVE t. ccc cece eee nene ft, ft. 
o Mull 


Periods that follow uppercase letters are not considered to be end-of- 
sentence marks. Therefore, they do not get the extra spaces that in general 
follow the sentences within the paragraphs. The \nul1 command produces 
an empty box, and it can be placed before such periods to mask the influ- 
ence of the uppercase letters. 


\TeX\null. \TeX. \TeX. Lise TeX. TeX. Tex. 


G.7 Breakpoints and Penalties 


o \penalty(penalty points) 


This contributes the specified number of penalty points if a line break (in 
horizontal mode) or a page break (in vertical mode) occurs at the location 
of the command. 


Documents 
o \bye \end 
These commands terminate the document. 
Pages and Lines 


o \break 


Within a paragraph, this command inserts a line break. Between para- 
graphs, it inserts a page break. 
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o \nobreak 


Within a paragraph, this command inhibits line breaks. Between para- 
graphs, it inhibits page breaks. 


o 


This command introduces a space character followed by \nobreak. The 
space character is treated like a standard letter and not as a word separa- 
tor. 


o Nallowbreak 


This command allows, but does not encourage, a breakpoint. 


Pages 


o \supereject \eject 


These commands insert a page break and, in the case of \supereject, 
also force all the floating insertions out. 


o \filbreak 


This command forces a page break at the location of the last \filbreak 
command that can be included in the current page. 


o \smallbreak \bigbreak \medbreak \goodbreak 


These commands end the paragraph and provide in the given order in- 
creased encouragement for a page break. When no page break is inserted, 
the commands reduce respectively to \smallskip, \medskip, \bigskip, 
and \par. However, here the latter commands introduce only the missing 
amounts of vertical space in locations that already contain vertical space. 


o \interlinepenalty=(dimension) 
This provides the penalty for inserting a page break within a paragraph. 
o \clubpenalty=(penalty points) 
This provides the penalty for inserting a page break after the first line of 
a paragraph. 
o \widowpenalty=(penalty points) 
This provides the penalty for inserting a page break before the last line of 
a paragraph. 
o \predisplaypenalty=(penalty points) 
This provides the penalty for inserting a page break before a displayed 
formula. 


o \postdisplaypenalty=(penalty points) 


This provides the penalty for inserting a page break after a displayed 
formula. 
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\displaywidowpenalty=(penalty points) 


This provides the penalty for inserting a page break before the last line in 
a paragraph that precedes a displayed formula. 


Paragraphs 


o 


o 


o 


Li 


o 


o 


o 


\par 
This command terminates the paragraph, if in horizontal mode. 
\noindent 


This command starts a new paragraph with no indentation, if in vertical 
mode. 


\indent 


This command starts a new paragraph with an indentation of dimen- 
sion \parindent, if in vertical mode. It inserts a horizontal space of size 
\parindent, if in horizontal mode. 


\leavevmode 


This command starts a new paragraph with an indentation of dimension 
\parindent, if in vertical mode. 


\everypar{(token list)} 


This command inserts the token list at the start of each paragraph when- 
ever vertical mode switches to horizontal mode. The token list causes an 
endless loop if it tries to reach vertical mode. 


nes 


\linepenalty=(penalty points) 
This provides the penalty points to be charged for each line break. 
\adjdemerits=(penalty points) 


This provides the penalty points to be charged for adjacent lines that 
largely vary in the amount of stretching and shrinking they provide to the 
spaces. 


\pretolerance=(penalty points) 


When TEX breaks a paragraph into lines, it stretches and shrinks the 
spaces between the words, and it calculates for each line the number of 
penalty points that the line accumulates as a result of the stretching and 
shrinking of the spaces. The first priority of TEX is to obtain line breaks 
without hyphenating words, and TpX considers this to have been done 
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successfully if none of the lines accumulates more penalty points than the 
number recorded in the pseudovariable \pretolerance. 


Example of Source Text Corresponding Formatted Text 


\def\x{Increased tolerance Increased tolerance 
makes \TeX’s life easier, makes TpX's life 
but the paragraphs \dots} easier, but the para- 


graphs ... 
\hsize=1in \x Increased 
tolerance makes 
\pretolerance=10000 \x TEX's life easier, 
but the 
paragraphs ... 


o \tolerance=(penalty points) 


If TEX is not able to break a paragraph into lines without hyphenating 
words, it tries to break the paragraph while allowing hyphenated words. In 
such a case, TgX considers the task to have been done successfully if none 
of the lines accumulates more penalty points than the number recorded in 
the pseudovariable \tolerance. 

o \emergencystretch=(dimension) 


If TEX is not able to break a paragraph into lines within the limits that 
\pretolerance and \tolerance impose, it adopts the best line-breaking 
result that it can achieve within lines whose lengths are allowed to ex- 
tend by the dimension that is recorded in \emergencystretch. The extra 
stretchability is provided free from penalty points. 


Words 
o \- 


'This command allows a line break within the word, and inserts the hyphen 
symbol ‘-’ at the end of the line if a line break is introduced. 


o \hyphenation{meth-od me-thod-ic) 
This command instructs TeX where the listed words can be hyphenated. 
o \showhyphens{(words separated by spaces)} 


This command displays where the listed words can be hyphenated. (As a 
side effect, the command produces an underfull box.) 


o \lefthyphenmin=(number) 
\righthyphenmin=(number) 


These commands do not allow line breaks within the specified numbers of 
leading and trailing characters in the words. 
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o \discretionary{(tezt,) H(tezt2) }{(texts)} 


This command inserts (tezts) if it can be inserted entirely in the same 
line with no breakpoints. Otherwise, it inserts the two pieces (tezt,) and 
(tezt2) with a line break between them. 


Example of Source Text Corresponding Formatted Text 


\def\x{\discretionary{zuc-} | zucchino, zucchino, zucchino, zuc- 
{chino}{zucchino}} chino, zucchino, zucchino. 


\x, M, \x, NE, NX, NX. 


\hyphenchar(internal font name)=(character code) 


o 


\defaulthyphenchar=(character code) 


The pseudovariable ‘\hyphenchar(internal font name)’ determines the 
character to be used in hyphenated words within the specified font. A 
character code out of the range 0 to 255 asks that the words will not be 
hyphenated. 


When the \font command loads a font (internal font name), it initializes 
the pseudovariable ‘\hyphenchar(internal font name)’ to the value that is 
recorded in the pseudovariable \defaulthyphechar. In the default setting, 
the pseudovariable \defaulthyphechar holds the character code of ‘-’. 


o 


NVuchyph- (number) 


A positive number in the pseudovariable allows hyphenation of words and 
a negative number does not allow. 


o 


\hyphenpenalty=(penalty points) 


This pseudovariable records the number of penalty points charged for a 
line break that occurs within a word. 


[*] 


\exhyphenpenalty=(penalty points). This pseudovariable holds the num- 
ber of penalty points charged for a line break that occurs after the hyphen 
character ‘~’. 


Math Formulas 


o Mk 


This command allows a line break within the formula and inserts the times 
symbol ‘x’ at the end of the line if a line break is introduced. 


o \binoppenalty=(character code) 
\relpenalty=(character code) 


'These pseudovariables specify the penalty points to be charged for line 
breaks after binary and relational operations in inline formulas. 
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G.8 Shapes of Paragraphs 


o \item{(token list)} 
\itemitem{(token list)} 


These start a new paragraph whose left margin is adjusted by the amount 
\parindent or 2\parindent, respectively. The parameter serves as a label 
for the paragraph. 


Example of Source Text Corresponding Formatted Text 

\parindent=3em Mtemía.] a. The \item command tem- 

The {\tt\char92item} command porarily increases by \par- 

temporarily increases by indent the value of \left- 

{\tt\char92par\-indent} the skip. 

value of {\tt\char92leftskip}. The old value of \item is re- 
\item{} The old value of stored when the paragraph 

{\tt\char92item} is restored ends. 

when the paragraph ends. b. The label is typeset within 
\item{b.} The label is a box. 


typeset within a box. 
o \hangafter=(integer) 
\hangindent= (dimension) 


These indent the lines of the paragraph. 


Example of Source Text Corresponding Formatted Text 
\hangafter=2 \hangindent=-1in A negative value in \hangindent 
\noindent A negative value asks for indentation at the right. A 
in {\tt\string\hangindent} positive value asks 


asks for indentation at the for indentation at 

right. A positive value asks the left. 

for indentation at the left. A negative value 
in \hangafter 

\hangafter=-2 \hangindent=1in asks for indentation at the top. A 

\noindent A negative value positive value asks for indentation 

in {\tt\string\hangafter} at the bottom. 

asks for indentation at the 

top. A positive value asks 

for indentation at the bottom. 


o Mhang. 
This indent the paragraph. 
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Example of Source Text 


\def\x{The magnitude of the 
indentation is determined 
by {\tt\string \par 
\-indent}.} 

\parindent=2em 

\par \x 

\par \hang\x 

\par \hang \noindent Mx 
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Corresponding Formatted Text 


The magnitude of the indenta- 
tion is determined by \parindent. 


The magnitude of the inden- 
tation is determined by \par- 
indent. 


The magnitude of the indentation 
is determined by \parindent. 


o \parshape=n (indent;)(length;) - - - (indent »)(lengthn) 


Example of Source Text 


\parshape=4 0.20in 1.87in 
0.4in 1.67in 0.65in 1.42in 
1.0in 1.07in \noindent 

The $n$ leading lines in the 

paragraph are assigned the 

specified lengths and 
indentations. The remaining 
lines assume the properties 
of the $n$th line. 


o \narrower 


o Nobeylines 


o \textindent{(token list)} 


\tt\meaning\textindent.... 
}\ignorespaces 


o \vadjust{(tezt)} 


Example of Source Text 


The \vadjust{\hrule} 
first line of this 
paragraph is underlined. 


Corresponding Formatted Text 


The n leading lines in the para- 
graph are assigned the spec- 
ified lengths and inden- 
tations. The re- 

maining lines as- 

sume the proper- 

ties of the nth line. 


This increases the values that the variables \leftskip and \rightskip 
hold by \parindent, to get narrower paragraphs. 


This treats each input line as a paragraph. 


This is a variant of the \llap command for placing labels on paragraphs. 


macro:#1->\indent \llap {#1\enspace 


This inserts the parameter in vertical mode after the line that contains 
the command. 


Corresponding Formatted Text 


The first line of this paragraph is 
underlined. 
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G.9 Templates for Text 


Independent Lines 


o \linef{(token list)} 


This command produces a horizontal box of size \hsize with the speci- 
fied content. It is likely to produce underfilled and overfilled boxes if the 
content does not contain fillers. Similarly, it is likely to produce overfilled 
lines if it is encountered within a paragraph. 


\leftline{(token list)} 
\rightline{(token list)} 
\centerline{(token list)} 


o 


These commands produce horizontal boxes of size \hsize with contents 
that are aligned by \hss commands. 


Headlines and Footlines 


o \headline={(token list)) 
\footline={(token list)} 


These variables respectively hold the specifications for the headlines and 
footlines. 


o \pageno 


This variable records the page numbers. TgX uses the command \advan- 
cepageno to modify the values in the variable, and the command M olio 
for printing the values of the variable. 


G.10 Floating Inserts 


Figures 


\topinsert (token list)\endinsert 
\midinsert (token list)\endinsert 
\pageinsert (token list)\endinsert 


o \holdinginserts=(number) 


These determine whether floating inserts should be processed in the cur- 
rent page. A number that is equal to 0 allows the processing of such 


224 CATALOG OF COMMANDS 


insertions; a positive number does not allow the processing of such inser- 
tions. 


Footnotes 


o \footnote{ (label) H (token list)} 
\vfootnote{ (label) (token list)) 


These commands produce footnotes that have the expansion of (token list) 
for their content, and are labeled with (label). For instance, the command 
‘\footnote{$*{\dag}$}{Text in footnote.}’ has been introduced at 


the end of this sentence.! 

These commands are ignored in some locations, such as vertical boxes, 
horizontal boxes that are encountered in horizontal mode, and floating 
insertions. The Nvfootnote command does not produce labels within the 
running text. 


\footnoterule 


o 


This is the command that TeX employs for inserting the horizontal lines 
that separate the running text from the footnotes. The properties of the 
separating line can be modified by redefining the command. 


G.11 Templates for Tables 


\settabs A B c 
3 \columns 5 P E 
\+ A& B& C\cr 
M a& b& c\cr 
\settabs AB c 

a b c 


\txx& xxxxx& x\cr ^ sample 
\+ Ag B& C\cr 
\+ a& b£ cNcr 


o Ncleartabs 


This command clears all the tabs that Nsettabs produces, if it does not 
appear between ‘\+’ and \cr. Otherwise, the command removes only the 
tabs that follow. 


T Text in footnote. 
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o \tabalign 


This command produces the same outcome as ‘\+’. The only difference 
between the two commands is that ‘\+’ is defined with \outer. 


ABC 
abc 


\halign{ 
#& #& #\cr 4 template 


A& B& C\cr 
a& b& c\cr} 


\valign{ 
\hbox{\strut \quad#}& 
\hbox{\strut\quad#}& 
\hbox{\strut\quad#}\cr 
A& B& C\cr 
a& b& c\cr} 


QU» 
ocv 


The \valign command is a dual of the \halign command. In particular, 
the first command inserts each entry into a vertical box, whereas the second 
command inserts each entry into a horizontal box. The vertical boxes typeset 
standard text to paragraphs of width \hsize. 


$$\eqalign{ at+b=c+d 
atb &= ctd\cr a+b>a 
atb &\geq a\cr}$$ 

$$\eqalignno{ at+b=c+d (*) 
atb &- ctd & (*) \cr atb>a (*«) 
atb &\geq a & (**)\cr}$$ 

$$\leqalignno{ (*) a+b=c+d 
atb &= ctd & (*) \cr (xx) at+b>a 


atb &\geq a & (**)\cr}$$ 


$$\cases{ Us quiam 
a^n£ if $a>b$\cr 


b*n& otherwise\cr}$$ 
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: 12 3 
$$\matrix{ 
1&%2&3\cr 4 5 6 
4&5 & 6 \cr}$$ 
$$\pmatrix{ P 2 J 
1&2&3\cr 4 5 6 


4 & 5 & 6 \cr}$$ 


The next command produces the same outcome as the previous com- 
mand, but with the addition of an introductory row and column. The entries 
in the first row are treated as labels for the columns, and the entries in the 
first column are treated as labels for the rows. 


$$\bordermatrix{ ? a 
?2&a£b&cNcr z/1 2 3 
x&1&2&3 \cr y\4 5 6 


y & 4 & 5 & 6 \cr}$$ 


The next command centers (with \hfil) the given formulas in separate 
lines. 


$$ Ndisplaylinesi a+b 
atb \cr cde 


f*g (*) 


c*d*e Ncr 
\hfill f+g \hfill 
\llap{(*)} \cr}$$ 


o \tabskip=(glue) 


This command specifies the amount of space to be inserted between 
columns in horizontal tables and between rows in vertical tables. 


o \everycr={(token list)} 
This command instructs TEX to insert the token list after each \cr. 
o \ialign{...} 


This command is a variant of \halign that assigns zero to \tabskip and 
an empty list to \everycr. 


o \hidewidth 


This is a filler that assigns width 0 to the entries that contain the command. 
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o 


o 


o 


\span 

\multispan{(integer)} — ' 

These commands are replacements for '£' that combine entries. 
\omit 


This command instructs TEX to use the template ‘#’ for the current entry, 
instead of the template that is given for the current column. 


\noalign{ (token list)} 
This command inserts an ordinary piece of text between the rows. 
\eqno \leqno 


These commands flush the specified labels in displayed formulas respec- 
tively rightward and leftward. 


\endinput 
This command is an alias of \cr. 
\crer 


This command is a variant of \cr that is ignored immediately after a 
\cr or a \noalign. Normally used within definitions of table-generating 
macros. 


G.12 Line Drawing 


Horizontal mode: \vrule width 40pt height Spt depth Opt = 
Vertical mode: \hrule width 40pt height Spt depth Opt m 


G.13 Fillers 


Invisible Fillers 


\hfil \vfil \hss i \hfilneg 
\hfill \vfill \vss \vfilneg 


Visible Fillers for Horizontal Mode 


\hbox{\vrule\vbox to 20pt{\vfil}} 
\hrulefill ae ar, 
MDOTFILL eee eee 
\leftarrowfill e 
\rightarrowfill — 
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\hbox to 40pt{\downbracefill} —— Thickness of braces de- 

\hbox to 40pt{\upbracefill} —_— pend on height of the 
boxes. 

\leaders\hbox{:}\hfill titi: Alternatives: \hfil 
and other types of 
boxes. 


Visible Fillers for Vertical Mode 


\vbox{\hrule\hbox to 40pt{\hfil}} 
\vtop to 25pt{\leaders Alternatives: Nvfil and 
\hbox{- - -}\vfill} other types of boxes. 


G.14 Data Elements 


Integers, Dimensions, and Token Lists 


\newcount (variable) \(variable)=... 
\newdimen(variable) \the (variable) 
\newskip(variable) \romannumeral 
\newmuskip(variable) \advance (variable) by ... 
\newtoks (variable) \multiply(variable) by (integer) 
\chardef (variable)= (integer) \divide (variable) by (integer) 


\mathchardef (variable)=(integer) 


o \afterassignment (token) 


This temporarily removes (token) from the input until an assignment in- 
struction is executed. The token is lost permanently if another Nafteras- 
signment command is reached before the execution of an assignment in- 


struction. 
Example of Source Text \divide\cA by\cB 
\newcount\cA \multiply\cA by\cB 
\newcount\cB \newcount\cC \advance\cC by-\cA 
\def\modulo{%, \the\cC} 
\afterassignment \modA \modulo 17 3, 
\cA=} \modulo 199 by 5. 
\def\modA{\cB=0 
\afterassignment \modB Gotresponding Formaited Test 
\advance\cB} 


\def\modB{\cC=\cA 2, 4. 
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Pseudovariables 

\catcode (character code) \lecode(character code) 
\mathcode(character code) \uccode(character code) 
\delcode (character code) \sfcode(character code) 
Selectors 


Mif (condition) (true part)\fi 
Mif(condition) (true part) Nelse(false part)\fi 


\ifdim(dimension) (= , « ,») (dimension) \ifx(token) (token) 
\ifnum(integer) (7 ,<,>) (integer) \if (nonezpandable token) 
\ifodd(integer) (nonezpandable token) 
\ifcase(integer) ...\or ... \ifcat(nonezpandable token) 
\ifhmode (nonezpandable token) 
\if vmode \ifmmode 


o \iftrue \iffalse 

These are conditional constructs that respectively test to true and false. 
o \newif\if (letters) . 

This defines a new selector named ‘\if(letters)’. 
o \(letters)false 

\(letters)true 

These assign the obvious value to the switch (letters). 


G.15 Groups 


o {(token list)} 
\bgroup(token list)\egroup 
\begingroup(token list)\endgroup 
o \aftergroup(token) 


This temporarily removes (token) from a group until the group is closed. 
Old tokens are not lost when new \aftergroup commands are encoun- 
tered. 


Example of Source Text . Corresponding Formatted Text 
\def\x{A} \begingroup CCC BBBBB,AAAA CC.AAA 
\catcode‘\A=13 

\defA{\aftergroup\x} 


CAACC {AABABBBAB, } 
CAC.\endgroup 
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G.16 Boxes 


\hbox{ (token list)} \box( variable) 
\vbox{(token list)} \copy (variable) 
\vtop{(token list)} \unhbox (variable) 
$\vcenter{ (token list)}$ \unvbox( variable) 
\newbox( variable) \ht (variable) 
\setbox(variable)=(boz) \dp(variable) 
\vsplit(variable) to (dimension) \wd (variable) 

H mode: Mower (dimension) (boz) \raise (dimension) (boz) 
V mode: \moveleft (dimension) (boz) \moveright (dimension) (boz) 


\everyhbox{(token list)} 
\everyvbox{(token list)} 


o \ifinner \ifhbox{(variable)} \ifvbox{(variable)} \ifvoid{(variable)} 
o \Llap{(token list)} ^ \rlapt(token list)} \smash{(token list)} 
\phantom{(token list)? ^ \hphantom{(token list)} 
\vphantom{(token list)} 
o \boxtopskip=(glue) 
\boxmaxdepth= (dimension) 


These specify the minimum distance between the top boundary of a box 
and the baseline of the top line in the box, and the maximum depth for 
the last line in the box. 


o \badness 


This command produces the number of penalty points charged for the last 
box that has been generated. 


G.17 Macros and Control Sequences 


\def \xdef Mong \expand \string 
\gdef \let \outer \noexpand \csname 
\edef \futurelet \global \expandafter \endcsname 


o \empty \space 
o \escapechar=(character code) 


This pseudovariable specifies the representation for an escape character 
that is converted into an ordinary character. 
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Example of Source Text Corresponding Formatted Text 
\tt\string\string \string/string 
\escapechar=‘\/ 

\tt\string\string 


G.18 Auxiliary Files 


\newread (buffer) \newwrite( buffer) 
\openin (buffer)=(filename) \openout (buffer)-(filename) 
\read (buffer) to (control sequence) Write — (buffer)t(token list)} 
\closein( buffer) \closeout (buffer) 
\ifeof (buffer) \immediate 
\input (filename) 

o \message{(token list)} 


o 


o 


o 


\errmessage{(token list) 

These commands write the expansions of the token lists on the terminal 
and into the log file. The second also prompts the user for directions. 
\wlog{(token list) 

This command writes the expansion of the token list into the log file. 
\newlinechar=(number) 

If the given number is a value in the range of zero to 255, then the character 
that has such a character code is a character that introduces line breaks 
within the output of the commands \write, \message, and \errmessage. 
If the number is outside this range, then no character introduces line breaks 
within the output. 

\inputlineno 

This pseudovariable holds the number of the line that TEX currently scans. 
\endlinechar(character code) 

This pseudovariable tells TEX which character should be appended to the 
end of the input lines. The default setting appends the character '^^M', 
whereas a character code out of the range 0 to 255 asks that no character 
will be appended. 

\jobname 

This command produces the name of the root file for the source text. 


G.19 Marks 


o 


\mark{(token list)} 
This marks the given entity, if it is not encountered within a box. It is 
ignored within boxes. 
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o \firstmark 

This extracts the first entity that has been marked in the current page. 
o \botmark 

This extracts the last entity that has been marked in the current page. 
o \topmark 

This extracts the last entity that has been marked before the current page. 
o \splitfirstmark 


This extracts the first entity that has been marked within the last box 
generated by \vsplit. 


o \splitbotmark 


This extracts the last entity that has been marked within the last box 
generated by \vsplit. 


G.20 Debugging 
\show \showthe \meaning 


o \batchmode 


This command instructs TeX to run without stopping for errors and with- 
out displaying information on the screen. 


o \nonstopmode 


This command instructs TgX to run without stopping, but display infor- 
mation on the screen. 


o \errorstopmode 


This command instructs TeX to run both stopping for errors and display- 
ing information on the screen. 


o \hbadness=(penalty points) 
\vbadness=(penalty points) 


These commands determine how far TgX will tolerate the overstretching 
of horizontal and vertical spaces without issuing warning messages. The 
commands have no effect on the amount of space that is inserted. 


o \hfuzz=(dimension) 
\vfuzz=(dimension) 


These commands determine how far TEX will tolerate overfilled horizontal 
and. vertical boxes without issuing warning messages. 
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o 


o 


\tracingmacros=(number) 


A value of 1 or more in the variable asks that the expansions of the macros 
be recorded in the log file. A value of 2 or more asks that all the ex- 
pansions be traced. The tracing is also displayed on the terminal when 
‘\tracingonline=(number)’ assigns a nonnegative value to this variable. 


\tracingstats=(number) 


A value of 1 or more in the variable asks that a summary of the memory 
usage be issued at the end of the compilation in the log file. A value of 2 
or more asks for a tracing of the memory usage along the compilation. The 
tracing is also displayed on the terminal when ‘\tracingonline=(number)’ 
assigns a nonnegative value to the variable. 


\errorcontextlines=(number) 


This command determines how deeply TEX will list the context in which 
errors occur. 


G.21 Other Commands 


o 


o 


o 


\everymath={(token list)} 
\everydisplay={(token list)} 
These indicate token lists to be inserted immediately after the opening 
delimiters ‘$’ and ‘$$’, respectively. 
Example of Source Text Corresponding Formatted Text 


\newcount\c (1)...2*9 = 5,(2)...9 42-1, 
\everymath{\global\advance\c (3)...z> 0. 
by 1 (\the\c)\ldots} 
$x*y-5$, $yt+z=7$, $z>0$. 
\endinput 
This instructs TEX to ignore the rest of the input file. 


\relax 
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Control sequences and keywords of TEX, that are not mentioned elsewhere in 
the book, are listed below without references. 


u (visible space), 16 
\u (control space), 17, 212 
! (exclamation point), 9 
! * (open exclamation į), 208, see 
also *« 
V! (negative thin space), 48, 214 
" (double quote or ditto), 165 
V" (dieresis or umlaut accent: 6), 209 
# (hash), see Mt and \char35 
within formal parameters, 7, 24, 65, 
71-72, 123, 130 
within templates of tables, 196 
M ( # ), 208 
$ (dollar), see \$ and \char36 
delimiters on math ($) and display 
math ($$) formulas, 7, 45-46, 
53, 123, 233 
\$ ($, £ ), 208 
% (percent), see \% and \char37 
indicators for comments, 7, 10, 
122-123 
\% ( % ), 208 
& (ampersand), see \& and \char38 
alignment characters within tables, 
7, 123, 189, 193-194, 198-199 
M ( &, & ), 208 
? (apostrophe or right quote), 48 
\? (acute accent: ó), 209 
23 ( » ) 48 
X* (discretionary x), 220 
\+ (begin tabbed line), 127, 193, 225 
\, (thin space), 48, 214 


- hyphens -, endashes - (--), and 
emdashes — (---), 8, 20, 176 
\- (discretionary hyphen), 219 
\. (dot accent: 6), 209 
/ (slash), 155, see also \slash 
\/ (italic correction), 216 
(colon), 9, see also \colon 
\; (thick space), 48, 214 
< (less than), 8, 20, 46, 122 
= (equal), optional within 
instructions, 77, 82, see 
also \afterassignment 
\= (macron accent: o), 209 
> (greater than), 8, 20, 46, 122 
\> (medium space), 48, 214 
? (question), 9 
?* (open question į), 208, see also ‘>’ 
\ (backslash), 15, 123 
^ (hat), see \char94 
superscript, 7, 47, 123, see also \sp 
^* indirect character prefix, 121-122 
X^ (circumflex accent: ô), 209 
e :! 
_ (underscore), see \_ and \char95 
subscript, 7, 47, 123, see also \sb 
V (-) 
* (reverse apostrophe or left 
quote), 48 
for indirect character 
codes, 124, 164 
X* (grave accent: ò), 209 
ce ( * ), 48 
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{, } (braces), 7, 43, 68, 123, 125, see 
also ‘{’, ‘}’, \char123, and 
Nchari25 

aliasing for, 109 

as delimiters for groups, 39, 54, 229 

as delimiters for parameters, 43, 
66-67, 110, 123-124, 167 

optional, 47, 67 

MC), 155, 207 

| (vertical line), 8, 20, 46, 122, see 
also Nchar124 and \vert 

M CIL), 155 

\} () ), 155, 207 

^ (tilde), see \char126 

tie character, 7, 30, 123, 128, 217 

\* (tilde accent: o), 209 

| see \overfullrule 


A 


\aa (A ), 208 

\aa (4), 208 

\above, 157, 208 
\abovedisplayshortskip, 164, 214 
\abovedisplayskip, 164, 214 
\abovewithdelims, 208 
Abrahams, Paul W., 234 
\accent, 209 

accents, 163-164, 209 

active characters, 123, 128 
\active (category code 13), 166 
\acute ( ó ), 209 
\adjdemerits, 218 
\advance, 79, 83 
\advancepageno, 223 

\AE ( Æ ), 208 

Nae ( æ ), 208 
\afterassignment, 228 
\aftergroup, 229 

\aleph ( ^ ), 207 
\allocationnumber 
\allowbreak, 217 

\alpha ( @ ), 46, 205 
\amalg ( Il ), 206 

\angle( Z ), 207 

angstrom unit, see NAA 
\approx ( ~ ), 206 

\arccos ( arccos ), 207 
\aresin ( arcsin ), 207 
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\arctan ( arctan ), 207 
\arg ( arg ), 207 
\Arrowvert 
\arrowvert 

Nast (+ ), 46, 206 
\asymp ( x ), 206 

at, 210 

\atop, 157, 208 
\atopwithdelims, 208 


B 


Wb ( o ), 209 

\backslash, 155, 207 

\badness, 230 

\bar (6 ), 209 

baselines, 37, 53, 135 

\baselineskip, 34, 37, 85, 163, 213 

\batchmode, 232 

Bechtolsheim, Stephan von, 234 

\begingroup, 39, 43, 229 

\belowdisplayshortskip, 164, 214 

\belowdisplayskip, 164, 214 

Berry, Karl, 234 

\beta ( 8 ), 46, 205 

Vf (bold), 19, 158-159, 163, 209 

\bffam, 161-163 

\bgroup, 109, 229 

\Big, \big, \Bigg, \bigg, \Bigg1, 
\biggl, \Biggm, \biggm, \Biggr, 
\biggr, Bigl, Vbigl, \Bigm, 
\bigm, \Bigr, \bigr, 208 

big- O (uppercase italic letter oh) 

\bigbreak, 217 

\bigcap (large f), 156, 206 

\bigcirc (large o), 206 

\bigcup (large | J), 156, 206 

\bigodot (large ©), 206 

\bigoplus (large (D), 206 

\bigotimes (large ()), 206 

\bigskip, 29, 85, 213, 217 

\bigskipamount, 85, 164, 213 

\bigsqcup (large | |), 206 

\bigtriangledown (large v), 206 

\bigtriangleup (large 4), 206 

\biguplus (large (+J), 206 

\bigvee (large \/), 156, 206 

\bigwedge (large A), 156, 206 

\binoppenalty, 220 
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blank lines in input files, 9, 16 
\bmod ( mod ), 208 
Borde, Arvind, 234 
\bordermatrix, 226 
\bot ( L ), 207 
\botmark, 104, 172-173, 184, 232 
\bowtie ( ba ), 206 
Xbox, 170, 230 
boxes, 52-60, 70, 85-86, 168-172, 230 
actions for all, see \everyhbox and 
\everyvbox 
alignment of, 53-55, 169 
bounding, 52 
braces for, 54, 109 
dimensions of, 53, 57-58, 85-86, 
168, 170 
for controlling line breaks, 54 
horizontal, 54 
overfilled and underfilled, 57, 172 
shifting, 169, 230 
splitting, see \vsplit 
testing, 96, 172, 229 
vertical, 54-55, 169 
within horizontal and vertical 
modes, 53, 55, 169 
within math formulas, 56-57 
see also spaces around and within 
boxes 
\boxmaxdepth, 230 
bp (big point), 211 
\brace, 208 
\braceld 
\bracelu 
\bracerd 
\braceru 
\bracevert 
\brack, 208 
\break, 30, 174, 184-185, 216 
breakpoints 
around display math formulas, 
217-218 
discretionary, 219-220 
encouraging and discouraging, 
174-176 
for lines, 30, 103, 105, 174-175, 216, 
218-219 
for pages, 30, 51, 174-175, 184, 
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216-218 

see also spaces around breakpoints 
\breve ( à ), 209 
\brokenpenalty 
\buildrel, 208 
\bullet ( e ), 46, 206 
by, 79, 82-83, 228 

optional, 82 
\bye, 8, 29, 73, 216 


C 


\c (cedilla accent: 9), 209 
\cal (calligraphic caps), 158-159, 163, 
209 
\cap ( N ), 46, 206 
\cases, 84, 191, 225 
\catcode, 125, 127, 165, 229 
category codes, 122-124, 165-167 
and macros, 123-125, 127 
changing the algorithm for 
assigning, 125 
retrieving and testing, 123-124 
timing of attachment of, 126-129 
cc (cicero), 211 
\cdot ( - ), 46, 206 
\cdotp (- ), 205 
\cdots (--- ), 46, 205 
\centering 
\centerline, 223 
centimeter, 211 
\char, 3, 23-24, 81, 122 
characters, 7-8, 16, 22-24, 120-130, 
162-167 
end-of-line, 9, 81, 122 
escape, 15, 122-123, 230 
representations of, 23, 121, 164, 166 
special, 7, 122-123 
symbols for, 22-24, 121-122, 
162-163 
token, 16 
see also active characters, codes, 
lowercase characters, and 
uppercase characters 
\chardef, 164, 166, 228 
\check ( ò ), 209 
\chi ( x ), 205 
\choose, 157, 208 
\circ ( o ), 46, 206 
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\cleartabs, 224 
\closein, 101, 231 
\closeout, 103-105, 231 
\clubpenalty, 176, 217 
\clubsuit ( & ), 207 
cn (centimeter), 211 
cmbx, cmbxti, cmex, cmitt, cmmi, cmr, 
cmsl, cmsltt, cmsy, cmtcsc, 
cmti, cmtt fonts, 20, 135, 160, 
209-210 
codes 
category, see category codes 
character, 24, 94, 120-124, 164 
lowercase and uppercase character, 
166-167 
math character, 162, 164, 167 
space factor, 215-216 
\colon ( : ), 205 
\columns, 193, 224 " 
comments, 10, 123 
\cong ( & ), 206 
control 
symbols, 15 
words, 15 
characters, 122 i 
control sequences, 15, 47, 64, 70, 104, 
127 
aliasing for, 107 
converted to strings, 115 
indirect references to, 114-115 
inspecting the meaning of, 72-73, 
86 
primitive, 16 
space characters after, 18 
\coprod (large T), 206 
\copy, 171, 230 
\copyright ( © ), 208 
\cos ( cos ), 207 
computing the function, 98 
\cosh ( cosh ), 207 
\cot ( cot ), 207 
.\coth ( coth ), 207 
\count 
\countdef 
\cr, 189, 193, 224-226 
\crer, 227 
Xcsc ( csc ), 207 
\csname, 104, 114-115, 230 
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\cup ( U ), 46, 206 
D 


Md ( o ), 209 
\dag ( f ), 208 
\dagger (1 as binary operator), 206 
dashes, see -, --, --- 
\dashv ( d ), 206 
\day, 81 
dd (didót point), 211 
\ddag ( ł ), 208 
\ddagger (1 as binary operator), 206 
\ddot (6 ), 209 
\ddots ( `*. ), 205 
\deadcycles, 183 
debugging, 11-13, 72-73, 86, 232-233 
decimals, 83-84, 88 
\def, 64-65, 70, 110, 230 
\defaulthyphenchar, 220 
\defaultskewchar 
\deg ( deg ), 207 
degrees-° ( $*\circ$ ) 
\delcode ; 
\delimiter 
\delimiterfactor 
\delimitershortfall 
\Delta ( A ), 46, 205 
\delta (6 ), 46, 205 - 
depth , 177-178 
\det ( det ), 156, 207 
\diamond ( o ), 46, 206 
\diamondsuit ( Q ), 207 
\dim ( dim ), 207 
\dimen, 51 
dimensions 

flexible, 84-85 

rigid, 82-83 

scanning, 128-129 

testing, 94 

unit systems for, 25-26, 82, 

211-212 

see also ‘minus’ and ‘plus’ 
\discretionary, 220 
display math, see math formulas 
\displayindent, 214 
\displaylimits 
\displaylines, 226 
\displaystyle, 209 
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\displaywidowpenalty, 218 
\displaywidth, 214 

\div ( + ), 206 

\divide, 79, 83 
\dospecials 

\dot (6), 209 

\doteq ( = ), 206 
Motfill(........ ), 180 
Mots ( ... ), 47, 208 
\doublehyphendemerits 
\Downarrow ( |j), 207 
\downarrow( | ), 207 
\downbracefill (__~___), 228 
\dp, 85, 170, 230 

\dump 
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\edef, 110-112, 230 
\egroup, 109, 229 
Eijkhout, Victor, 234 
\eject, 217 

\e11 ( 2), 207 
Velse, 89, 93, 101, 229 
em, 25, 211 
\emergencystretch, 219 
\empty, 65, 230 
\emptyset ( 0 ), 206 
\end, 73, 216 
\endcsname, 114-115, 230 
\endgraf (alias for \par) 
\endgroup, 39, 43, 229 
\endinput, 105, 227, 233 
\endinsert, 50, 223 
\endline 
\endlinechar, 231 
\enskip, 212 
\enspace, 213 
\epsilon ( € ), 46, 205 
Neqalign, 189-190, 225 
\eqalignno, 190, 225 
\eqno, 190, 227 

\equiv ( = ), 206 
\errhelp 
\errmessage, 104, 231 
\errorcontextlines, 233 
\errorstopmode, 232 
escape character, 15, 122-123, 230 
\escapechar, 230 
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Veta (7 ), 205 

\everycr, 226 
\everydisplay, 86, 233 
\everyhbox, 86, 230 
\everymath, 86, 233 
\everypar, 78, 218 
\everyvbox, 86, 230 

ex, 26, 211 
\exhyphenpenalty, 176, 220 
\exists ( 3 ), 206 

Vexp ( exp ), 207 
\expandafter, 105, 113-114, 230 
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\fam, 162-163 
\fi, 89, 93, 101, 229 
figures, 50-51, 105, 144-145, 223 
fil, 211 
\filbreak, 217 
files 
importing, 100-101, 105 
names of, 17, 100-101 
reading, 101-103 
testing for existence of, 102 
writing, 103-105 
see also \endinput 
fill, 211 
fillers 
arrow-based, 227, see 
also Noverrightarrow and 
\underleftarrow 
brace-based, 228, see 
also \overbrace and 
\underbrace 
dot-based, 180 
line-based, 177-179, 222, 227-228 
space-based, 27-29, 58, 227 
tailoring, 180, 228 
11111, 211 
\finalhyphendemerits 
\firstmark, 105, 172-173, 184, 232 
\fivebf( sv.» ), 160, 162, 209 
\fiverm( sverm ), 159-160, 162, 209 
\fivesy, 159-160, 162-163 
\flat (> ), 207 
\floatingpenalty 
\fmtname (format of TEX) 
\fmtversion (version of TEX) 
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\folio, 223 
\font, 20-21, 161, 209-210 
\fontdimen 
\fontname, 20, 105, 210 
fonts, 19-24, 158-164, 209—210 
activating, 21 
adding, see \font 
external and internal names 
of, 20, 163, 210 
families of, 19, 161-162 
fixed size, 20 
listing symbols of, 93 
styles of, 161-162 
tables of symbols for, 20, 22-23, 
159-160 
\footins, 182, 185 
\footline, 34, 78, 223 
footlines and headlines, 34, 172-173, 
223-232 
\footnote, 224 
\footnoterule, 224 
\forall ( V ), 206 
formulas, see math formulas 
fractions, see ‘/’, \over, and Nabove 
\frenchspacing, 215 
\frown ( ~ ), 206 
\futurelet, 110, 230 


G 


\Gamma ( T ), 46, 205 
\gamma ( y ), 46, 205 
\ged ( gcd ), 156, 207 
\gdef, 70, 230 
\ge (>) 
\geq ( > ), 46, 206 
\gets (+ ), 207 
\gg ( > ), 206 
\global, 70, 77, 80, 83, 97, 108, 111, 
230 
\globaldefs 
glue, see spaces (shrinkable and 
stretchable) 
\goodbreak, 217 
\grave (6 ), 209 
Greek symbols, 205 
groups, 39-43, 52-53, 70, 127, 156 
blocked, 39-40, 43 
braced, 39-40, 43, 109 
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extracting tokens from, 229 
nesting of, 43 


H.e 


\H (long Hungarian umlaut: 6), 209 
\halign, 196, 201, 225 

\hang, 221 

\hangafter, 221 

\hangindent, 221 

Hargreaves, Kathryn A., 234 
\hat (6 ), 209 

\hbadness, 13, 232 

\hbar ( À ), 207 

\hbox, 54, 57, 230 

\headline, 34, 78, 223 

headlines, see footlines and headlines 
\heartsuit ( 9 ), 207 

height, 177-178 

hexadecimal, 165 

\hfil, 27-28, 30, 175, 181, 227 
\hfill, 27-28, 30, 175, 180, 227 
\hfilneg, 175, 227 

\hfuzz, 13, 232 

\hglue, 212 

\hidewidth, 201, 226 

\hoffset, 34-35, 82, 211 
\holdinginserts, 223 

\hom ( hom ), 207 
\hookleftarrow ( — ), 207 
\hookrightarrow ( — ), 207 
\hphanton, 230 

\hrule, 177, 227-228 
\hrulefill (____), 177, 227 
\hsize, 34-35, 37, 54, 82, 168, 211 
\hskip, 26, 85, 212 

\hss, 172, 227 

\ht, 85, 170, 230 

hyphenation, 8, 175-176, 219-220 
\hyphenation, 219 

\hyphenchar, 220 
\hyphenpenalty, 175, 220 
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M (1), 209 
\ialign, 226 
\if, 94, 124, 229 
\ifcase, 93, 229 
\ifcat, 124, 229 
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\ifdim, 94, 229 
\ifeof, 101, 231 
\iff ( «€ ) 206 
\iffalse, 229 
\ifhbox, 172, 230 
\ifhmode, 96, 229 
\ifinner, 96, 230 
\ifmmode, 96, 229 
\ifnum, 89, 229 
\ifodd, 90, 229 
\iftrue, 229 
\ifvbox, 172, 230 
\ifvmode, 96, 229 
\ifvoid, 172, 230 
\ifx, 95, 124, 229 
\ignorespaces, 214 
\Im ( $ ), 207 
\imath ( 2 ), 209 
\immediate, 104, 231 
in (inch), 25, 211 
Min ( € ), 46, 206 
\indent, 218 
indentations, 17, 36, 54, 134, 214, 218, 
221 
\int ( inf ), 156, 207 
\intty ( oo ), 207 
\input, 100, 105, 231 
\inputlineno, 81, 231 
\insert 
\insertpenalties 
Mint ( f ), 46, 156, 206 
integers, 78-83, 89-90, 128-129, 164, 
228 
alphabetical representations 
for, 81, 93 
arabic representations for, 80 
roman representations for, 81, 167 
testing, 89-90, 93, 229 
scanning of, 81, 92 
\interdisplaylinepenalty 
\interfootnotelinepenalty 
\interlinepenalty, 217 
\iota (2), 205 
\it (italic), 19, 158-159, 163, 209 
\item, 221 
\itemitem, 221 
\itfam, 161-163 
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M (3); 209 

\jmath ( 7 ), 209 
\jobname, 17, 105, 129, 231 
\joinrel 

Jones, David M., 235 

\jot, 211 
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\kappa ( « ), 205 

\ker ( ker ), 207 

\kern, 213 

Knuth, Donald E., xiii, 234 
Krantz, Steven, 234 


L 
VL ( Ł ), 208 
\1 (1), 208 


\Lambda ( A ), 205 
\lambda ( A ), 205 

Lamport, Leslie B., xiii, 234 
\land ( A ), 206 

\langle ( ( ), 155, 207 
\language, 105 

\lastbox 

\lastkern 

\lastpenalty 

\lastskip, 85, 213 

LaTpX, 150-151 

\lbrace ( { ), 155, 207 
Mbrack ( [ ), 207 

\lccode, 166-167, 229 
\lceil ( [ ), 155, 207 
\ldotp ( . ), 205 

\ldots ( ... ), 46, 205 

\le( <) 

\leaders, 180-181, 228 
\leavevmode, 16, 218 

\left, 155-156, 207 
\Leftarrow ( «- ), 207 
\leftarrow( — ), 207 
\leftarrowfill (0—————), 227 
\leftharpoondown ( — ), 207 
\leftharpoonup ( — ), 207 
\lefthyphenmin, 219 
\leftline, 223 
\Leftrightarrow( €» ), 207 
\leftrightarrow ( — ), 207 
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\leftskip, 34-35, 37, 42, 54, 85, 212 arguments and parameters 

\leq ( < ), 46, 206 of, 65-67, 71-72 

\leqalignno, 190, 225 blank lines (and \par) within 

\leqno, 190, 227 parameters of, 68 

\let, 107-108, 230, see also \futurelet controlling expansion of, 110, 

letters, 15, 64, 123, 125, 159 112-114 

Levy, Silvio, 234 debugging, 72-73, 233 

\lfloor ( | ), 155, 207 definitions of, 64-65, 110 

Mg (lg ), 207 incremental definitions of, 70, 114 

Mgroup local and global, 70, 114 

\Lhook ( €) named by active 

Min ( lim ), 156, 207 characters, 123, 128 

\liminf ( liminf ), 207 recursive, 64, 92-93, 95 

\limits scanning definitions of, 123-124 

\limsup ( limsup ), 156, 207 space characters within, 64, 68 

Mine, 223 with delimiters, 116-117 

line drawing, 227 see also category codes (and 
under text, see \underline and macros), control sequences 

\vadjust : (aliasing), and groups (within 
: within tables, 177-181, 202-204 macros) 
^Wlinepenalty, 218 \mag 
\lineskip, 163, 213 \magnification, 212 
\lineskiplimit, 163, 213 \magstep, 21, 210 


“.\11 (€ ), 206 


\1lap, 59, 172, 230 \magstephalf, 210 


\makefootline, 182 


\lmoustache 5 
Mn Cin ), 207 \makeheadline, 182 
\1not (7 ), 206 \mapsto (++ ), 207 
Mog ( log’), 207 margins, 35, 54 
\long, 68, 230 \mark, 172-173, 231 
\Longleftarrow ( <= ), 207 math formulas 
\longleftarrow (.+— ), 207 actions for all, see \everydisplay 
\Longleftrightarrow ( <=> ), 207 and \everymath 
Mongleftrightarrow ( «— ), 207 adjustable symbols over and under, 
\longmapsto ( — ), 207. 157, 209 
\Longrightarrow ( ==> ), 207 delimiters on, 155-156, 207-208 
\longrightarrow ( — ), 207 delimiters within, 157, 209 
Moop fractions within, 47 
\looseness labels on, 190 
Mor ( V ), 206 line breaks within, 220, see 
Moser, 169, 230 also \allowbreak, \break, and 
\lowercase, 167 penalty points 
lowercase characters, 43, 166-167 ordinary text within, 56 
testing for, 167 page breaks around display, 
M 217-218 
: subscripts and superscripts within, 
macros 47, 156-157, 208 


annihilating, 109 symbols and fonts 
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for, 46-48, 158-163, 205-208 
see also spaces for math formulas 
\mathaccent 
\mathbin 
\mathchar 
\mathchardef, 165, 228 
\mathchoice 
\mathclose 
\mathcode, 164, 229 
\mathhexbox 
\mathinner 
\mathop 
\mathopen 
\mathord 
\mathpalette 
\mathpunct 
\mathrel 
\mathstrut 
\mathsurround 
\matrix, 192, 226 
\max ( max ), 156, 207 
\maxdeadcycles, 183 
\maxdepth, 182, 211 
\meaning, 72-73, 105, 129, 232 
\medbreak, 217 
\medmuskip, 214 
\medskip, 29, 85, 213, 217 
\medskipamount, 85 
memory, 92, 164, 233 
reclaiming, 109 
\message, 231 
\mid ( | ), 206 
\midinsert, 223 
millimeter, 25, 211 
\min ( min ), 156, 207 
minus, 26, 84 
\mit (math italic), 158-159, 163, 209 
\mkern, 214 
mm (millimeter), 25, 211 
mode 
horizontal and 
vertical, 10, 56, 96, 229 
inner, 56, 96, 229 
math, 45, 57, 96, 229 
\models ( } ), 206 
\month, 81 
\moveleft, 169, 230 
\moveright, 169, 230 
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\mp ( F ), 206 
\mskip, 214 

nu (math unit), 211 
\mu ( g ), 205 
\multiply, 79, 83, 228 
\multispan, 199, 227 
\muskip 

\nuskipdef 
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\nabla ( V ), 207 
\narrower, 222 
\natural ( h ), 207 
\ne ( Æ ), 206 
\nearrow( / ), 207 
\neg ( > ), 206 
\negthinspace, 212 
\neq ( Æ ), 46, 206 
\newbox, 169, 230 
\newcount, 78, 228 
\newdimen, 82, 228 
\newfam, 162 
\newhelp 
\newif, 96, 229 
\newinsert 
\newlanguage 
\newlinechar, 103, 231 
\newmuskip, 228 
\newread, 102, 231 
\newskip, 84, 228 
\newtoks, 76-77, 228 
\newwrite, 103, 231 
\ni ( 5 ), 206 
\noalign, 191, 198, 227 
\noboundary 
\nobreak, 30, 136, 217 
before whatsit, 105 
\noexpand, 105, 113, 230 
\noindent, 17, 218 
\nointerlineskip, 213 
\nolimits 
\nonfrenchspacing, 215 
\nonscript 
\nonstopmode, 232 
\nopagenumbers 
\normalbaselines, 213 
\normalbaselineskip, 163 
\normalbottom 


INDEX 


\normallineskip, 163 
\normallineskiplimit, 163 
\not, 206 

\notin ( ¢ ) 

nu ( v ), 205 

\null, 216 
\nulldelimiterspace 
\nwarrow ('‘\_ ), 207 


Oo 


\o(@) 

\o (Ø) 

\oalign 

\obeylines, 222 

\obeyspaces, 215 

\odot ( © ), 206 

\OE ( Œ ), 208 

\oe ( œ ), 208 

\offinterlineskip, 203, 213 

\oint (large $), 206 

\oldstyle (0123456789), 209 

\Omega ( Q ), 205 

\omega ( w ), 205 

\ominus ( © ), 206 

\omit, 198, 227 

\ooalign 

\openin, 101, 231 

\openout, 103-105, 231 

\openup, 200, 213 

\oplus ( @ ), 206 

\or, 93, 229 

\oslash ( @ ), 206 

\otimes ( @ ), 206 

\outer, 73, 127, 230 

\output, 78, 182, 184-185 

\outputpenalty, 182-183 

\over, 47, 208 

\overbrace, 157, 209 

overfull lines and pages, 13, 16, 27, 55, 
57-58 

\overfullrule, 13, 16 

\overleftarrow, 209 

\overline, 209 

\overrightarrow, 209 

\overwithdelims, 208 

\owns ( 3 ), 206 
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VP ( 4 ), 208 
\pagebody, 182 
\pagecontents, 182 
\pagedepth, 212 
\pagefilllstretch, 212 
\pagefillstretch, 212 
\pagefilstretch, 212 
\pagegoal, 211 
\pageinsert, 50, 223 
\pageno, 81, 223 
pages, 9-10, 34, 52, 58, 78, 104, 135, 
141 
footlines and headlines for, 
see footlines and headlines 
layout and dimensions of, 33-37, 42, 
211-212 
numbering of, see \pageno and 
\folio 
lost spaces at the top of, 30 
see also breakpoints for pages 
\pageshrink, 212 
\pagestretch, 212 
\pagetotal, 212 
\par, 16, 218, see also \endgraf 
paragraphs, 9, 16-17, 35-37, 58, 212, 
221-222 
actions for all, see \everypar 
closing lines of, 27-28, 38 
\parallel ( || ), 206 
parameters, see macros (arguments and 
parameters) 
\parfillskip, 38 
\parindent, 34, 37, 42, 54, 82, 212 
\parshape, 222 
\parskip, 34, 37, 85, 212 
\partial, 207 
\patterns 
\pausing 
pc (pica) , 211 
\penalty, 175, 216 
penalty points, 174-176, 217-219, 232 
\perp ( L ), 206 
\phantom, 59, 230 
\Phi ( 9 ), 205 
\phi ( ¢ ), 205 
\Pi ( II ), 205 
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\pi ( r ), 46, 205 

pica, 211 

\plainoutput, 182 

plus, 26, 84 

\pm ( + ), 206 

\pmatrix, 192, 226 

\pmod (z (mod y)), 208 
point (printers’ unit), 25, 211 
\postdisplaypenalty, 217 
pound sterling £ ({\it \$}), 208 
\Pr ( Pr ), 156, 207 

\prec ( < ), 206 

\preceq ( < ), 206 
\predisplaypenalty, 217 
\predisplaysize 
\pretolerance, 218 
\prevdepth 

\prevgraf 

\prime ( ! ), 207 

\proclaim 

\prod ( [] ), 156, 206 
\propto ( œ ), 206 

pseudo variables, 164-166, 170, 215 
\Psi ( Y ), 205 

\psi ( V ), 205 

pt (printers’ point), 25, 211 
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\qquad, 212 
\quad, 212 


R 


\radical 
\raggedbottom 
\raggedright 
\raise, 169, 230 
\rangle ( ) ), 155, 207 
\rbrace ( } ), 155, 207 
\rbrack ( ] ), 207 
\rceil ( ] ), 155, 207 
\Re ( R ), 207 
\read, 101, 231 

from the terminal, 102 
\relax, 17, 26 
\Relbar ( = ) 
\relbar ( — ) 
\relpenalty, 220 
\removelastskip 


INDEX 


\repeat 

\rfloor ( | ), 155, 207 

\rgroup 

\rho ( p ), 205 

\rhook (° ) 

\right, 155-156, 207 
\Rightarrow ( — ), 207 
\rightarrow ( — ), 207 
\rightarrowfill (————>), 227 
\rightharpoondown ( — ), 207 
\rightharpoonup ( — ), 207 
\righthyphenmin, 219 
\rightleftharpoons ( = ), 207 
\rightline, 223 

\rightskip, 34-35, 37, 42, 54, 85, 212 
\rlap, 59, 172, 230 

\rm (roman), 19, 158-159, 163, 209 
\rmoustache 

\romannumeral, 81, 129, 228 
\root, 208 


\rq(’) 
S 


S ( 8 ), 208 

\sb (alias for subscript _) 

scaled, 21, 210 

scope of changes, 41, 70, 77, 83, 97, 
108, 111, 125 

\scriptfont, 161 

\scriptscriptfont, 161 

\scriptscriptstyle, 158, 162, 209 

\scriptspace 

\scriptstyle, 158, 162, 209 

\scrollmode 

\searrow ( N ), 207 

\sec ( sec ), 207 

selectors, nesting and processing 
of, 89, 91-92 

Seroul, Raymond, 234 

\setbox, 85, 170, 230 

\setlanguage, 105 

\setminus ( \ ), 206 

\settabs, 193-194, 224 

\sevenbf( sevenbf ) 160, 162, 209 

Nsevenrn( sevenrm ), 159-160, 162, 209 

\sevensy, 159-160, 162-163 

\sfcode, 215-216, 229 

\sharp ( # ), 207 
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\shipout, 182-183 
\show, 73, 232 
\showbox 
\showboxbreadth 
\showboxdepth 
\showhyphens, 219 
\showlists 
\showthe, 86, 232 
\sigma ( c ), 205 
\sim ( ~ ), 206 
\simeq ( ~ ), 206 
\sin ( sin ), 207 
computing the function, 98 
\sinh ( sinh ), 207 
\skew 
\skewchar, 163 
\skip 
\skipdef 
\s1 (slanted), 19, 158-159, 163, 209 
\slash (*/* with break allowed), 208 
\slfam, 161-163 
\smallbreak, 217 
\smallint ( f ), 206 
\smallskip, 29, 85, 213, 217 
\smallskipamount, 85, 163, 213 
\smash, 230 
\smile ( — ), 206 
sp (scaled point), 211 
\sp (alias for superscript ^) 
\space, 65, 230 
space characters, 17, 64, 68, 81, 117, 
193, 214 
absorbed, 23, 26, 64, 68, 81 
between words, 9 : 


leading and trailing in input lines, 9 


\spacefactor, 215 
spaces, 25-29, 212-214 
after punctuation symbols, 9, 
215-216 
around and within math formulas, 
48, 214 
around and within boxes, 161, 172 
around breakpoints, 30, 175, 212 
at the start of lines, pages, and 
paragraphs, 30, 135, 212 
between fonts, 216 
between lines, 37, 213 
between paragraphs, 29, 37, 212 
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between words, 10, 215-216 
lost, 23, 26, 40, 48, 64, 81, 193, 212 
shrinkable and stretchable (glue), 
27-28, 172 
unwanted, 40 
\spaceskip, 215 
\spadesuit ( @ ), 207 
\span, 199, 227 
\special, 105 
Spivak, Michael, 235 
\splitbotmark, 232 
\splitfirstmark, 105, 232 
\splitmaxdepth, 185 
\splittopskip, 185 
spread 
\sqcap ( r1), 206 
\sqcup ( L ), 206 
\sqrt, 208 
computing the function, 98 
\sqsubseteq ( E ); 206 
Msqsupseteq ( I ), 206 
Mss ( — ), 208 
\star ( x ), 206 
\string, 105, 115, 129, 230 
\strut, 161, 203 
\strutbox, 161 
\subset ( C ), 46, 206 
\subseteq ( C ), 46, 206 
\succ ( > ), 206 
\succeq ( > ), 206 
\sum ( V5 ), 46, 156, 206 
\sup ( sup ), 156, 207 
\supereject, 51, 217 
\supset ( D ), 206 
Msupseteq ( D ), 206 
\surd ( y ), 207 
\swarrow( / ), 207 
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\t ( 60), 209 

\tabalign, 225 

tables, 189—204, 224-227 

\tabs 

\tabskip, 200, 226 

\tan ( tan ), 207 

\tanh ( tanh ), 207 

\tau (7 ), 205 

\tenbf( tenbf ), 160, 162-163, 209 
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\tenex, 160, 162 
\teni( teni ), 159-160, 162-163 
\tenit( tenzt ), 160, 162-163 
\tenrm( tenrm ), 159-160, 162-163, 
209 
\tensl( tens! ), 160, 162-163 
\tensy, 159-160, 162-163 
\tentt( tentt ), 160, 162-163 
\Tex ( TEX ) 
\textfont, 161 
\textindent, 222 
\textstyle, 158, 162, 209 
\the, 77, 79-80, 82, 105, 112, 123, 129, 
210, 228 
\Theta ( © ), 205 
\theta ( 0 ), 205 
\thickmuskip, 214 
\thinmuskip, 214 
\thinspace, 212 
\tilde (6 ), 209 
\time, 81 
\times ( x ), 206 
to, 57-58, 101, 171, 201, 230 
\to, 207 
token lists, 76-78 
tokens, 15 
aliasing, 108, 110 
expandable and nonexpandable, 
104-105, 111-113 
meaning of, 95, 108, 115, see 
also \meaning and \show 
testing, 94-95 
\toks 
\toksdef 
\tolerance, 219 
\top ( T ), 207 
\topglue 
\topins, 51, 182, 185 
\topinsert, 50, 223 
\topmark, 105, 172-173, 184, 232 
\topskip, 211 
\tracingall 
\tracingcommands 
\tracinglostchars 
\tracingmacros, 73, 233 
\tracingonline, 233 
\tracingoutput 
\tracingpages 


INDEX 


\tracingparagraphs 
\tracingrestores 
\tracingstats, 233 
\triangle ( A ), 207 
\triangleleft ( < ), 46, 206 
\triangleright (p> ), 46, 206 
true, 212, 229 
\tt (typewriter), 19, 158-159, 163, 
209 
\ttfam, 161-163 
\ttraggedright 
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\u (6 ), 209 

\uccode, 166-167, 229 

\uchyph, 220 

\underbar 

\underbrace, 157, 209 

underfull lines and pages, 13, 26-27, 55, 

57-58, 219 

\underline, 209, see also \vadjust 

\unhbox, 171, 230 

\unhcopy, 171 

units of measure, see dimensions (unit 

systems) 

\unkern 

\unpenalty 

\unskip 

\unvbox, 171, 230 

\unvcopy, 171 

\Uparrow ( ft ), 207 

Nuparros ( f ), 207 

\upbracefill (~~m —), 228 

\Updownarrow ( {} ), 207 

\updownarrow ( Î ), 207 

\uplus ( W ), 206 

\uppercase, 43, 167 

uppercase characters, 43, 166-167 
before periods, 216 
testing for, 167 

\Upsilon ( T ), 205 

\upsilon ( v ), 205 

v 

\v ( à ), 209 

\vadjust, 222 


\valign, 225 
\varepsilon( € ), 205 
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\varphi ( 9 ), 205 
\varpi( w ), 205 
\varrho ( 9 ), 205 
\varsigma ( ç ), 205 
\vartheta ( V ), 205 
\vbadness, 13, 232 
\vbox, 54, 58, 230 
\vcenter, 169, 230 
\vdash (+ ), 206 

\vdots ( : ), 46, 205 

\vec ( g), 209 

\vee ( V ), 206 

Mert ( || ), 207 

\vert ( | ), 207 

\vf£il, 29-30, 58, 175, 181, 227 
\v£il1, 29-30, 58, 175, 181, 227 
\vfilneg, 175, 227 
\vfootnote, 224 

\vfuzz, 13, 232 

\vglue, 212 

\voffset, 34-35, 82, 211 
\vphantom, 230 

\vrule, 178, 227 

\vsize, 34-35, 58, 82, 211 
\vskip, 28, 85, 212 
\vsplit, 171, 185, 230 
Wss, 172, 227 

\vtop, 55, 58, 230 

Vulis, Michael, 234 


WwW 


\wd, 86, 170, 230 

\wedge ( A ), 206 

whatsits, 105 

\widehat ( 3 ), 209 

\widetilde ( o ), 209 

\widowpenalty, 217 

width, 177-178 

\wlog, 231 

\wp ( p ), 207 

Wr ( 0), 206 

\write, 103-105, 141, 231 
timing of execution, 104 
to the terminal, 104 


X 


\xdef, 111, 230 
\xi ( E ), 205 
\xi ( € ), 205 
\xleaders 
\xspaceskip, 215 


Y 

\year, 81 

Z 

Mzeta ( € ), 205 
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